The subject came up again last night. Owen bought a receiver (not new) and supposedly in good functioning condition. He couldn’t get it to do anything but sit there and click. He downloaded the “manual” or what claimed to be the manual. He still could not figure out how to make the receiver tell the speakers to make noise. He couldn’t find the information and there was no index.

“Yes,” I said. “It’s because people like me are obsolete. No one writes manuals. They are either generated automatically via software, usually from developer’s notes, or when the item comes from Japan, written by the manager’s 13-year old niece and her English-Japanese dictionary.”

I wrote this. Then I rewrote it to make it better.

A few months ago, a friend complained that the company who made his expensive new camera should fire their tech writer. Because the manual was useless. Mind you it had a lot of pages, but none explained what the functions were supposed to do, or what turning them on would accomplish. If anything. I often think a lot options in our cameras are there to keep the development team busy and have no known use — which is why no one tells you what to do with them because they don’t know what to do with those settings either.

The real problem is they got rid of technical writers long ago. We are living with the result. These companies never hired a technical writer or there would be a manual.

It’s our own fault. If we had made a fuss the first time we bought a wildly complicated and expensive item and got no manual, we should have made a fuss. We shouldn’t have to spend thousands of dollars to get a complex device with a generated leaflet or worse, something that looks like a business card or a set of pictures without words. If we had demanded it, we would get documentation. With an index, a table of contents, screenshots. Information explaining not only where to find a function, but what that function does. Why, for example, you might want to use it.

Years went by during which the work I did consumed most of my life. I got up, got dressed, scraped the ice off the car, went to work. I stopped for coffee along the way. Between having done the same kind of work for a long time and perpetually racing against a deadline, life was busy but I turned out good material.

I also knew, no matter what the advertisement said, no job was permanent. I would work until the book was finished, then I’d have to move on because even the best boss won’t pay you for doing nothing. Well, at least not very often.

The industry in which I worked ultimately decided the work I did was worthless. Who needs a manual to tell explain how to use equipment that costs a gazillion dollars and controls the operation of a steel mill? Or a missile tracking system? Or a satellite grabber for use out in space? They can always call the help desk — especially from space or a battle zone.

I was the one who organized chaotic information and tested it to make sure it did what it was supposed to do. If I had anything to do with it, the software worked as intended. I made sure there was a table of contents, index, chapters, screen-shots, and diagrams so you would not always have to call someone. Considering the state of tech support these days, you can see where this failure to supply reasonable documentation has landed us. That’s why the phones are always busy and why the quality of support is so bad. How often do you find that you know more than the “help tech” individual? If you can’t fix it by rebooting, you are in trouble.

The help desk people don’t have manuals either. No one wrote one and more to the point, no one takes the time to properly train the tech team. There are a few good ones and it’s a blessing when you actually meet one, but most are helpless.

You need help. They want to help (or supposedly want to help), but no one trained them and they don’t have a manual to which they can refer. Oops.

But — I was obsolete.

You need developers and a boss because someone has to say why you are all gathered here this morning. Also, the boss makes sure there’s coffee and if he is a very good boss, donuts.

But a writer? They only hired me if they were at the end of a production cycle, realized the contract required they deliver documentation. Sometimes, I got as little as three weeks to learn a product and produce a book that looked professional. At that point, no one cared what was in the book or whether the information would be of any use to anyone. It just had to be big, thick, nicely designed, and weigh enough to use as a doorstop.

My days were numbered. Eventually, I was gone.

To substitute for professional writers, they created software for automated documentation, i.e. raw data generated by a program using “comments” left by developers, many of whom speak English as a second or third language and in any case, do not understand how non-engineers think. Or how to organize information so users can find it.

It turns out, we were willing to pay buckets of cash for undocumented products. So I guess they were right. No one cares until they run into a problem — which might be the day they set it up the device or a few weeks or months down the road. Which is when they discover “free tech support” is only “free” for three months. After that, they want money and in some cases, a lot of money.

You used to be able to buy books about cameras and computers on Amazon. They were expensive, but worth the money. I’m not even sure that’s true anymore. My best bet is finding people online who own and use similar products and ask questions.

For all of you who believe that crappy documentation is because tech writers are lazy? We aren’t lazy. What we are is fired.

Categories: Customer Service, Humor, Marilyn Armstrong, Retirement, Technology, Work

Tags: , , , ,

6 replies

  1. As for Owen’s problem, ask him to check the back of the receiver for a “jumper” or “U” connection output/input point where the receiver was/can be used as a pre-amp to drive a separate power amp. if the jumper is missing there will be no input to the receiver’s power amp section, hence, no sound from the speaker outputs. Jumpers can easily be made from a 14, or, preferably,12 gauge “solid” wire (You need two) for left and right.

    If this is not the case, and the unit continues to not work, you need to open the device and look for blown rail fuses. These fuses are used to protect the output stage from accidental shorting of speaker terminals, and simple replacement will/should restore operation. Be sure to install the correct value(s). Tell Owen to call me if he needs more info.


  2. Sadly the lack of coherent instruction goes for things or software you might already own. My Photoshop package, bought in 2000 (ish) is obsolete (by Adobe’s standards) and archaic. At least Adobe provided support (troubleshooting) until 2019. Then Adobe climbed aboard the Microsoft Greed Train and now charges if you want to ask even the simplest question. My Photoshop went south this year for some reason. There’s nobody to answer my questions as to why. I allegedly OWN the damned software. I paid handsomely back in 2000 for it. But apparently, because it’s old and Adobe has turned greedy nobody will take a moment to explain why my package stopped working. Reinstalling it has been futile. I have a 200+ page manual that came with the package, but it doesn’t cover whatever the current issue is.

    It’s not only that manufacturers don’t hire technical writers any longer (and editors? How quaint. We don’t need no stinkin’ editors); manufacturers apparently have also given customer service and satisfaction the boot too. That attitude is bleeding over into face-to-face transactions and service as well. Tell me, can’t we just call the whole thing off?


    • I think my (old) copy of Photoshop is a bit newer than yours, but not much. It still (reluctantly) works and I suspect it will stop working any day now. I will not subscribe to it. It’s VERY expensive and this is a hobby and I’m poor, so something else will have to do the job.


  3. I once had a job at the University of Calgary to create a user manual for Touch Screen Tech. That was in it’s infancy at that time. Not sure if every really took off though I do see occasional applications. But like you and I said, who wants figure prints all over their computer monitor.

    Liked by 1 person

Talk to me!

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Tish Farrell

Writer on the Edge



Light Motifs II

Paula Light's Writing Site | The Classic Edition

Touring My Backyard

Rediscovering Singapore

Our Eyes Open

Come along on an adventure with us!

Travel with me

Travel snapshots from Toonsarah

Thoughts & Theories

My Personal Rants, Ravings, & Ruminations

France & Vincent

Writing Magic, Myth and Mystery

Barb Taub

Writing & Coffee. Especially coffee.

This, That, and The Other

Random musings on life, society, and politics.

Keep it alive

A look at life, achieving good physical and mental health and happiness

Covert Novelist

Light Hearted Mysteries

Salted Caramel

Blogging, Motivation, Lifestyle and much more.

Sarah's Attic Of Treasures

Making My Home A Haven is important to me. Sharing homemaking skills. Recipes and food. Bible Studies. This is a treasure chest of goodies. So take a seat. Have a glass of tea and enjoy. You will learn all about who I am.

Green Screen

The Environmental Movie Podcast

bushboys world

Photos of my world and other stuff I hope you will enjoy too. Photos taken with Canon PowershotSX70HS Photos can be purchased.


Independent views from someone who offers some historical context

My Blog

Just another WordPress.com site

National Day Calendar

Fun, unusual and forgotten designations on our calendar.

Cee's Photo Challenges

Teaching the art of composition for photography.

Trent's World (the Blog)

Random Ramblings and Reviews from Trent P. McDonald

Views from the Edge

To See More Clearly

serial monography: forgottenman's ruminations

wandering discourse, pedantic rant, self-indulgent drivel, languorous polemic, grammarian's bête noire, poesy encroachment approaching bombast, unintended subtext in otherwise intentional context, unorthodox unorthodoxy, self-inflected rodomontade, …

draliman on life

Because sometimes life just makes you stop and think

The English Professor at Large

Posts about old Hollywood, current concerns

Sparks From A Combustible Mind


Chronicles of an Anglo Swiss

Welcome to the Anglo Swiss World


Your Source For The Coolest Science Stories

%d bloggers like this: