The strangest computer manual ever written
ironicsans.substack.com
ironicsans.substack.com
https://en.wikipedia.org/wiki/Tigerfibel
https://archive.org/details/Der-Generalinspekteur-der-Panzer...
Some examples:
https://youtu.be/gwf5mAlI7Ug - (Mechanical Computers) U.S. NAVY BASIC MECHANISMS OF FIRE CONTROL COMPUTERS MECHANICAL COMPUTER INSTRUCTIONAL
https://youtu.be/s1i-dnAH9Y4 - (Mechanical Computers) Basic Mechanisms In Fire Control Computers
https://www.youtube.com/playlist?list=PL9cQ2Ddo6YCwNcDh15h2I... - Mechanical Computers (navy series)
https://youtu.be/yYAw79386WI - Around The Corner - How Differential Steering Works (1937)
https://youtu.be/ezRP1h6x2GE - Vintage training film - Manhandling - 1962
https://youtu.be/-34vk-rahPk - BODY SEARCH | Spy Training Film (Vintage, ca. 1942-1945)
https://youtu.be/acGXBJv6AT4 - Vacuum Tubes 1943 Training Film (The TRIODE) Signal Corps Army Air Force Radio
https://youtu.be/0OmOQs0ziSU - 16 Inch Gun Training Film (1955)
Better quality here: https://www.youtube.com/watch?v=xzS5xdSeS10
Another interesting thing was how unpolished and DIY some of the documentation. For example, I got a vintage (circa Apple II?) Anadex dot matrix printer at a yard sale, and the manual included instructions for how to select the kind of serial interface (between, e.g., RS232 and closed-loop): by cutting a PCB trace inside. Not even a DIP switch, but they were fine telling customers it was OK to start permanently mangling a circuitboard to get it to work with their computer.
Edit: This might've been the one: https://www.ebay.com/itm/143078871954
> Caution: Although the ABS is very effective, always remember that braking capability is limited by tire traction. Always adjust your driving speed according to the road and traffic conditions. Do not let the extra safety afforded by the ABS tempt you taking extra risk. The ABS cannot overcome the laws of physics.
Is this the cute part? My car's manual from 2015 has practically the same wording, and it looks more like a fact than a joke or reference.
Starting FORTH is like this, and I love that book, but I can see how it would have irritated a lot of people from the era it was written in.
Those early ACEs and the Apple's lawsuit were before my time, but then I live in a former USSR satellite state, so we were 10-15 years behind, tech-wise. Growing up in the 90s, I've seen plenty of similar humor and illustrations in various computer books, and I believe the reason for them was the same as in the US in the 80s: personal computers were new.
Computers were a completely new category of appliance, never seen before, alien. Most people in the market for them were first-time buyers, who didn't know anything about these machines, or what to do with them - at best, maybe they had a friend at local university or in some office that worked with them. Those people (or, perhaps in most cases, their kids) had to learn not just the operating basics (where the power button is, where you plug peripherals in), but completely new abstractions and conceptual frameworks - files and folders, data vs. code, CLI interfaces, later GUI interfaces. Clicking. Double clicking. It was overwhelming, and whether learning was worth it wasn't obvious.
Thus, all these cutesy drawings, all that humor and personality and conversational tone, served a critical function: to defuse the apprehension people had. To make the reader feel safe. "Sure, the computer seems like a complicated beast, but it's more of a friendly, if a little silly, pet you'll want to befriend. Yes, it's often frustrating, we feel that too. But look, now you know how to use it, and nothing broke. Wasn't that hard, was it?".
The generation of my parents needed that. My generation grew up exploring them on our own. The next generation was born to a world in which computers were ubiquitous, and learned from osmosis. So the manuals could go back to their usual, boring, utilitarian style we all love when we're not deadly afraid of the once-in-a-lifetime conceptual framework shift.
Of course it's not how things turned out.
The enlightenment comes when you spot the trick and realized you now know more about an otherwise boring subject than you would have had you only skimmed the manual.
I'm going to add that I don't think Rpi is a good substitution for 8/16 bit machines. It's difficult to go to the bottom of things (except for Pico) and when you do go to the bottom it is too complicated to wrap your head around it. 8/16-bit machines such as NES/Apple/SNES/8086 are easier to "digest". I read on HN that some good console programmers can map the whole memory into his brain.
Resource constraint is really a boon, not a curse.
If you want them to enjoy what they're doing, you can show them something else more modern and useful like maybe how to use the GPIO pins on a Raspberry Pi or something to turn things on or off. If you make computing into a weird punishment all you'll end up achieving is guaranteeing disappointment.
Since this is the first computer he encounters, he doesn't have anything easier to compare with. As I said if he frustrates out then it's fine, I'll give him maybe a Rpi then, nothing big deal, but if he can grit through the initial period I prepare to teach him QuickBasic first and then C if he is interested, all about game programming. It was the way kids in the 80s learned programming and I think the only obstacle is his lack of interest/intelligence and access to easier electronics.
Let me frame this differently. Your father or grandfather cut the grass with a sickle. Why aren't you doing the same thing? You can buy a sickle even now. Yet, you presumably use an electric or gas mower. Why not a sickle?
Because a sickle sucks and it was fine for the time. Not now.
PS. After a kid has frustrated out, it's already too late. You're never getting them back because they've already decided they hate it. Lots and lots of kids with parents who wanted to live through them again or wanted them to be a clone of the parent, and these kids rebelled against their planned lives. Same thing with parents who force their kids to eat a food that they've already expressed that they do not like the taste of it. They don't suddenly start liking the food when they are older. Listen to what they're saying, don't force it. This isn't the army.
Check out the pictures here: https://deskthority.net/viewtopic.php?t=17354
The RESET key is so well-hidden it's not even visible in the first picture. In the second picture, you can see the notch along the back of the keyboard near the numeric keypad. In the third picture, with the cover removed, you can how the key extends backward at a perpendicular angle.
You're never going to hit that thing by mistake. You might not even realize it exists until someone points it out to you.
Remember the original computer didn't have a disk yet. The only storage was a cassette tape operating at 6000 baud. You didn't hack on it by editting a text file and then compiling it from storage, you programmed in-memory (either in BASIC or by hand-assembling instructions at the monitor). Then you tried it, and if it worked you started worrying about how to get that pickled to storage in a recoverable way.
It was a different world, and "reset" was absolutely a critical feature.
But yeah, fast forward a few years and the median user was "running" software and not writing it, and we all forgot about why it was there.
But one nice feature was that if you were simply programming in BASIC and immediately typed OLD after hitting "Break", you had a chance of recovering your program if you weren't unlucky.
And the other feature which this comment reminded me of - at least some models of the BBC Micro had a hardware lock on the "Break" key, so with a small screwdriver you could turn a little piece of plastic to completely prevent the key being pressed!
https://en.wikipedia.org/wiki/The_Secret_Guide_to_Computers
Weird illustrations and humor and pretty eclectic and very opinionated coverage, from hardware to different operating systems to CS concepts, and the author said you could call him at home for free tech support if you bought the book. (I never tried that part, though.)
At first, computer lessons were, of course, given by the maths teachers, but they got bored with the things, and then Dutch language teachers took over, with rather more success.
(I ended up writing a school results tracking database for the Franklin computer, and after that, the computer was moved into the office, and I never saw it again.)
Defenestrate works for objects as well.
Also why games from the era were so much better.
Hard disagree.
Not always. In the 80's,a lot of people in my country, Spain, were self-taught. They loved computers but they also loved reading books and lots of comic books. In the 90's if you were into computers it wasn't weird to be a fanfiction writer or manga sketcher to copy some Dragon Ball drawings.
I had no idea what the singer's real name was before now.
I'm known for writing documentation that is useful AND, let's say, entertaining. Or, depending on your inclination, sed 's/entertaining/hilarious/g'
Besides docu and Wiki pages (what unfortunately counts for docu in many companies), I've written man pages and shell scripts with more jokes than a longint can probably count.
Once had a shell script that did something really, really impactful and asked the user in increasingly aggressive prompts if he is sure, then delved into existentialism and how he can even be sure that he is so sure. Another prompted the unfortunate victim to validate that gravity, in fact, still works. Long story.
Some have deemed that "unprofessional", especially management. I am elated to see that this has precedence in print, and shall use this to make my case.
Oh, I have writing samples available. If anyone wants to hire a guy to write funny manuals or some other stuff, ping me :D
Please share!
> Oh, I have writing samples available. If anyone wants to hire a guy to write funny manuals or some other stuff, ping me :D
Would you consider doing the same for a fun free software project that just aim to share knowledge about how http works?
As for the other thing, not at this time. Again, truly sorry! I'm a bit overwhelmed in my life right now, maybe some later time. But can you send me a link to the project nonetheless, if there is one?
Found it: https://archive.org/details/Getting_Started_with_TRS-80_Basi...
I guess this should also be a question to ask anybody looking to buy a high end computer today: "Sir, before you buy this, please name two uses of this computer which cannot be done by a $400 PC."
PS: I am joking.
I'm still thinking about the first.
On the other hand I am always coming up with bent pieces of metal I really want.
With the conclusion that a sheet metal cutter would be far more useful than a 3d printer, so that is what I am going to get.
It's not just baubles, either, each thing improves my life somehow. To the holder of the falling toilet seat, to the toothbrush holder, to the sink sponge case.
And the argument of "couldn't you go to the store to get some of those things" is the same as saying "couldn't you go to the laundromat to wash your clothes"? Yes I could, but once you're used to the convenience and speed, you'll never go back.
Most of what I print are publicly available models, but some of them I did myself.
What I have done: shower head support, various boxes, curtain hooks, phone stand, drain filter, novelty dices, etc... Most of these I would never have thought of before I got my printer, and yet, these are actually useful stuff. For example, for the curtain hooks, before I had the 3D printer, I had to buy some that didn't quite fit because the original one that broke are not available anymore, and sometimes, they fell. The new ones I printed to measurements fit perfectly. That's the idea, you need something, you print it. Of course, there are many things you can't print or it makes no sense to, but it really is useful.
Also I originally underestimated PLA, it is actually quite strong. There are even ways of making it heat resistant (regular PLA starts to deform at around 60C, which can happen in a hot car).
That being said, it is still a hobby. 3D printers, especially the cheap ones are far from consumer friendly and you need to be familiar with its workings and how to setup your slicer. And there is the big one: CAD. You can limit yourself to printing others people models, but you would be missing on a lot of potential.
This may be a user's manual, but when it comes to some programs that you buy off the shelf, you're more in a position of being used than you are of being a user.
Reminds me of the modern "you are the product" adage, and shows user-hostile software was already a thing 40 years ago.
Reading some of his articles the other day (written for MacUser), there was no negativity, no angst, no flame war (but a healthy dose of irony); just pure enthusiasm about the cool new things we could do with the cool new computers and assorted gizmos. We could use more of that.
They are filled with cartoons and jokes.
Frankly it’s not clear to me how that interacts with the anti-circumvention clause of the DMCA, but most software licenses are based on an outright lie: that you need a license to load the program into memory and execute it after having legally acquired the code.
Borland did seem to be a playful company in contrast to Microsoft, their main rival.
The last category of crooks is under the heading “Us”:
I wonder if the capitalisation "US" was also a deliberate reference.
This seems weirdly relevant still and should be taught to people (maybe without any overly Franklin-specific technicalities).
The real joke of ‘Territorial Imperatives of the Trumpeter Swan’ was in its acronym.