3 ms·
The Apple ][ reference manual, when read from today's perspective, seems almost as out of touch, but in the opposite direction. From the first lines in the Intr
by danso 9y ago
The Apple ][ reference manual, when read from today's perspective, seems almost as out of touch, but in the opposite direction. From the first lines in the Introduction:
http://www.classiccmp.org/cini/pdf/Apple/Apple%20II%20Reference%20Manual%20-%20Woz.pdf http://www.classiccmp.org/cini/pdf/Apple/Apple%20II%20Refere...
"Like the Apple itself, this book is a tool. As with all tools, you should know a little about it before you start to use it. This book will not teach you how to program. It is a book of facts, not methods. If you have just unpacked your Apple, or you do not know how to program in any of the languages available for it, then before you continue with this book, read one of the other manuals accompanying your Apple."
It goes on to list the "Apple II Basic Programming Manual" and "The Applesoft Tutorial".
I recently helped my mom purchase a Macbook for personal use. She's retired now but she used to work somewhat as a programmer in the COBOL-era. She was deeply annoyed at me telling her not to worry that the Macbook didn't come with a user manual, just Google for things online. I'm about 4 years into my current Macbook so I'd had forgotten what if any documentation came packed with it. I was surprised how hard it was to find a user manual on Apple's website, and even then, it was fairly skimpy, and not particularly accurate -- the book was described as being for the non-Touch Bar version of the MBP, but it still had a Touch Bar section confusingly plopped into the middle of the other MBP topics, including references to ports that don't exist on the lower-end 2-USB-port model.
Even today it's pretty controversial to push coding literacy (not necessarily because coding isn't seen as valuable, but in terms of curriculum priority). Back then, to even understand the Apple ][ user manual, you were told to in its introduction to first read up on how to program in BASIC. I can imagine why a computer expert back then would be skeptical of the value of personal computing.
- dsr_ 9y agoBack when people bought software on physical media [pre-1999, basically], all decent software came with physical documentation. Games might come with a center-stapled 32 page manual; Turbo Pascal for Windows came with a multi-book reference set. For more than a decade, IBM PCs and their successors came with gray cloth-covered three-ring binders full of manuals and references. It was a different era.
- GuiA 9y agoIt was indeed a different era. Nowadays, people are editing photos, videos, recording podcasts, publishing their own books, all using tools that allow for more complexity than what any professional could do a couple decades ago, all without even having to read a single piece of documentation!
- TeMPOraL 9y agoNot true at all. To do the things you mentioned, they all have to "read" plenty of "documentation", usually in form of third-party text/video tutorials, or even training courses. In a way, these are all worse than what the official manuals used to be. What changed, unfortunately, is that the industry no longer seems to expect people to actually learn anything. In other professions, or even with things like driving, you're expected to learn and train before you can use a tool effectively. In computing, we somehow started to believe it's wrong, and thus we're making ever dumber and feature-less tools instead of telling people to suck it up and spend 30 minutes reading the included manual...
- GuiA 9y ago> they all have to "read" plenty of "documentation", usually in form of third-party text/video tutorials, or even training courses. That's an optional step, of course. But it is far from required. I remember for instance my brother downloading a copy of Audacity and instantly starting to record his voice and putting together radio shows. Of course, at some point, when he wanted to do complex stuff, he watched YouTube videos etc. But at this point he had already created many hours of content. And I don't think watching a 10 minute YouTube video of someone showing how to perform X is worse than reading a user manual. People learn by watching much better than they do by reading a manual - especially since documentation is rarely the first concern of most companies, and is therefore often lacking in thoroughness, poorly written/translated, contains very few pictures/diagrams if any, etc.
- khedoros1 9y ago> Of course, at some point, when he wanted to do complex stuff, he watched YouTube videos etc. But at this point he had already created many hours of content. He presumably had previous experience with operating other GUI programs, and experience with standard computer concepts like programs and files. The big benefit here is that a lot of GUI paradigms are shared between very different kinds of programs, so something that would've been explained in text in a bound manual in the past gets covered very early on, either through experimentation, or someone explaining it. > People learn by watching much better than they do by reading a manual Depends. Is it something highly visual? Or is there an intuitive visualization of a concept that I need a high-level understand of? Then sure, a video illustration is invaluable. Video was wonderful for learning to disassemble the trunk of my car to install a backup camera, replace my garbage disposal, and (back in the day) get an intuitive grasp of how sorting operations work. I hate videos for programming tutorials. They're slow, awkward, difficult to jump around easily, use a boatload of bandwidth, and are a hassle to save for later.
- Someone 9y agoThat seems to be the "for dummies" version :-). It does give a listing for the ROMs and tells you a lot about the hardware, but doesn't go into detail about the PCB layout. The 1978 version (digitally recreated in all its glory at http://www.classiccmp.org/cini/pdf/Apple/Apple%20II%20(Redbook)%20Reference%20Manual%2030th%20Anniversary.pdf http://www.classiccmp.org/cini/pdf/Apple/Apple%20II%20(Redbo...) gives PCB layout, timing diagrams, etc. If you have that, you can build an Apple 2