A special thanks to Paul Stenning at The Heathkit Schematic and Manual Archive, which is where I found the Heathkit material mentioned in both the article and video.
What Have We Done to the Written Word?
A special thanks to Paul Stenning at The Heathkit Schematic and Manual Archive, which is where I found the Heathkit material mentioned in both the article and video.
Have Articles, News Stories, Books and other documents become too brief and chopped up to be truly useful to anyone looking up information?
On March 11, 2023, I wrote a short blog post entitled "Oh, for the Love of Manuals!" regarding the decline in quality of manuals and the written word in general. Not only is it sad to see the discipline of writing go downhill, I am now of the opinion that the lack of good quality material whether it be factual or storytelling has an effect on the whole person.
A lack of explanation results in ambiguity.
Think about it, an abridged piece of writing demonstrates how the author's thought processes functions. Usually showing off lack of depth about the topic at hand. Sometimes the author's train of though can be fallowed, while at other times the lack of detail is frustrating for the reader. I was perusing a manual the other day and part way through the text they they showed a screen capture of an icon. Nowhere in the text did they define whet where this icon was in the program, much less give it a name and it was a bad screen capture to boot. How did this pass into the final printing of this book? I know people like to be able to zero in on snippets of a document now, but sometimes a little more detail would certainly help. Here's an example of the icon from the manual.(Now that the image has been enlarged by four times, I can just see enough detail to recognize the icon.)
![]() |
Enlarged image of icon shown. |
Nowhere in the book does it name the icon, it just says what it does, and really, can you tell what it is?--I can't.
Even if your preferred choice of format is audiobooks the same issue holds true. The difference in writing in the literature created only 30 years ago is astounding. Listen to this introduction from Carl Sagan's book "Pale Blue Dot" (or read it via the Open Library). The video below is hosted on YouTube and is part of the " carlsagandotcom" channel The wording used is eloquent and accessible, whether it is read or listened to this text is inspiring. Carl Sagan took the time to describe his vision. He didn't optimize the ideas for fast consumption, nor did he make any assumptions on what the reader already knew. This is why this three minute clip from YouTube is so widely appreciated. It is a story unto itself. When was the last time you heard or read something like this? This is writing,and it achieves its goal of informing fully and inspiring.
Imagine the textbooks Carl Sagan and others read when they were going through their various courses. Difficult to read perhaps by present-day standards, but well worth the effort. Even the illustrations would be well thought out in books and manuals, for example from a 1961 Heathkit: manual. In less than a page it describes clearly the technique for proper soldering. Click the picture to enlarge:
![]() | |||
Excerpts from the 1961 Heathkit Compact Hi Fidelity Speaker System manual model number AS-193 from The Heathkit Schematic and Manual Archive. Used under provisions: "Fair Dealing" Canada and "Fair Use" United States. (Click image to enlarge) |
The writing and diagrams in this manual is simply marvellous. Dare I say it is bursting with well-written information.
So how did we get from concise written guidance to "blurry icons"? One thing is for sure, in the soldering example, it is not assumed that the reader knows anything. Whereas in the blurry icons scenario the text assumes that that the reader does. It is to the point where they don't even describe the blurry image. Clearly we have gone too far in the direction of making everything a snippet of knowledge... at least they could've provided a keyboard shortcut 😀.
This overly abbreviated trend in the media and knowledge industry also has a side effect on how people learn. Especially if they are only exposed to abbreviated documents as they are beginning to think critically. Indeed how as Google and other search engines affected the way people educate themselves and the depth to which that knowledge goes, or lack of thereof.
Here's a question: How much time do you think has been invested in creating this text so far? The answer is over two hours (and a good eight hours later I am still at it) . Why, because first the soldering example had to be found, checked for copyright, and edited graphically from two printed pages down to one graphic. So even though I use voice dictation which makes entering the text for the most part rather painless, there is a fair bit of work that goes into these kind of things. The Internet is not a place to just upload things without checking. Not if you want your content to last.
But this article really is about the thought processes that are going on, as related to the use of knowledge and actually how we think. The depth to which those thoughts go and the understanding that is the result.
I marvel at minds that can seemingly just absorb and understand information. For me it's a much more effort intensive thing. I may have to go over something several times in order to really grasp the concepts. I do this willingly because it is only then your horizons expand. The other reality that must be accounted for is that everything takes time. Even though we may want to get something completed quickly, quality must trump everything else even when we are on a deadline at least to some extent. Yep in other words quality takes work.
Which brings up another point: With the ability now days for people to, how shall I put this, " Copy and Paste " just about everything you really have to resist that urge, because it can make the quality of the final product go down the toilet if one is not careful. (Have you looked at YouTube lately 👀 . Somebody post something original and within hours there are legions of copycats). However the creators that do put in the work and I can think of a few that only post every few weeks, really do come out far ahead.
To sum up. In order for people to do better in their lives they should seek out more detailed explanations and experiences. Do your best to try to get away from the "brief answer" mindset. In the long run you will benefit greatly and the experience you gain will even make your own brief answers better than the rest when you need to use them. And at the end of the day your brain will thank you 🙏.
Have a great day Patrick....
PS: Wait! This article is about to get a little longer with an example of the downsides of the overly brief approach to writing.
As many of you know I usually try to produce a short video to go along with each article. It takes time but usually the process follows smoothly. This time around however I decided to use a new tool to create the end credits of the video. I like to include all of my sources and licensing information just to keep things transparent. I wanted to create a scroll of text which included still images. My video editor was not up to the task so I decided to use an add on which according to its brief description could do exactly what I want.
The documentation however is a disaster and that includes the video tutorials all except for a few which ultimately saved the day. Most of the documentation was overly segmented and again assumed the reader was fully versed in the philosophy of use for this particular software. A simple scroll with pictures took about a week to do, and I don't know how many articles and videos I watched and read. Fortunately once I found a good bunch of videos the project was completed within the hour.
The point this_so is that all of the information is segmented and fragmented. Did the company who created the software ever sit down and really consider who the product and documentation was aimed at.?… I don't think so, and even the official material is fragmented. I'm avoiding mentioning the product name simply because it is not about the product, it is about the information supporting the product. Perhaps though the most annoying aspect of this hunt for information was the fact that the online documentation does not mention what version the information applies to.,and like all software, there are different versions over time and between computers. So I'm begging anyone who reads this… If you write documentation, please indicate right off the bat the version numbers it applies to.
The other issue is that maybe it's more a case of a fault of the search engines. A friend last night was mentioning that now days in 2024 it is much harder to find the information you are looking for online.