Oh, for the Love of Manuals!

Photo by: Todd Ehlers License:  CC BY-NC-ND 2.0

First I must apologize for those of you that have noticed the site hasn't been updated in a few days. This was due to a software problem, and yes also to due to a lack of clearly written manuals. So this particular topic is very pertinent.

I won't mention any brand names but suffice to say two things conspired to keep me busy for the last 48 hours.

1. An error in one of my accounts cost of shutdown of some of my software, right after I paid a not a substantial amount of money to renew a subscription.
   
   
2. A good deal of my software is bought and paid for, and that act of buying something used to mean that you got a decent instruction manual. Well those days are long gone. It is one thing to abridge something is it is another thing to completely miss large chunks of information.

This is what caused my conundrum for the last two days. Instruction manuals have now been shortened and abridged to such a point that they give nope your understanding of what is going on. Nor do they provide the author of the document a clear understanding of what is going on or how to accomplish a task. This is a recipe for disaster and very time wasteful.

If I see one more book indicating that I should "click on a tiny icon" (not even bothering to give it a name) I made last go insane. The other thing that is sadly missing now days is detailed descriptions of features or if the information is included it is so broken up with hyperlinks and options as to make the text completely unreadable.

Then of course there is the most common problem. The software update you just received completely changes how the program operates and thereby makes the manual null and void.

The photo at the top of this post is of a 1973 Heathkit (Wikipedia article) manual, which while being brief were incredibly well written. They had to be, because you were assembling electronic kits. This just goes to prove that it is possible to be brief and get give sufficient information. Even the books in my elementary school gave more information about a given topic and what you find in most periodicals today.

Each morning I am rather astounded by what passes for newsworthy material. One problem I see is that in order to keep companies visible on the Internet they must produce material every day and unless you've got a staff of thousands, okay that was a bit of an overstatement, the quality will inevitably go down. This blog is a perfect example each day I miss publishing usually results in the loss of 50 views.

Still there must be some way to maintain quality. Because quality really is the cornerstone of knowledge. It is what enables you to go beyond the written or spoken word because the concept has been fully conveyed. To do that takes time and effort.

Anyway this is just very quick blurb. Just to get things back on track.

 I'll write more tomorrow. Patrick

PS:  It looks like Heathkit store is back in business! I don't know if they ship to Canada yet but I see they have the next generation of their famous "digital clock" which I built when I was a teenager. I have to find out if they ship the Canada and if they do. Well how can I not build another one.