 |
 |
My apologies for polluting your inboxes with my personal rant, but here goes ... I demand documentation that has the following qualities: Comprehensive, Systematic, Local (which brings along the quality of Durable or Lasting), and Personalized Pacing. Lately, every time I ask for "documentation", people blithely steer me to some websites, and often specifically to videos. These in particular fail on every count: - Video collections are selective. Even if I diligently view all the videos (which would take too much of my time), they will not expose me to *every* aspect of the system, unlike traditional documentation. I.e., video collections fail to cover matters comprehensively. - Video collections do not provide a clear orderly path for viewing the entire collection, unlike traditional documentation with a fixed, known sequence of pages to follow. Websites are totally hopeless in this regard. And forget about leaving bookmarks so that I can pause and later pick up where I left off. So video collections fail at systematicity. - Streaming video collections require online connectivity at every moment. I cannot view streaming videos, or a website, while offline, unlike traditional documentation. This also makes them ephemeral, bound to disappear at the whim or fortunes of the provider; by contrast, traditional documentation lives with me, and lasts as long as I hold onto it. So video collections fail to be "local", and with that fail to be durable or lasting. - Video collections force me to proceed exactly at the pace of the video. Unlike traditional documentation, I cannot "skim" videos to get the gist of the content, and then come back to drill down to details of interest. So video collections fail the test of personalized pacing. Much of this critique applies to other forms of modern "documentation", e.g., websites and downloadable html collections in particular. A good .pdf, or set of .pdfs, however, may have these qualities, just as a traditional set of printed manuals did back in the day. Given a traditional manual set of, say, 1000 pages, I can master any system in a matter of days. Doing things the modern way puts me at the mercy of a chaotic collection of people of dubious mastery, and impedes my own attainment of mastery. OK, now you kids get off my lawn! -- dkm