Storage

Debugging the manual #1

The most taxing part of solving most problems in IT is taking the effort to read the user manual and find the right documentation, right?

The most taxing part of solving most problems in IT is taking the effort to read the user manual and find the right documentation, right?

Usually this is the case, but what happens when the official documentation is totally unreadable?



Yesterday I was asked to help out a friend with their external hard drive. It was nothing trivial but the computer wasn't recognising the hard drive when plugged into the USB port. The person I was helping wasn't savvy with computers and confused by the piece of text copied below. They thought the following was using computer acronyms and "fancy computer talk".



Whopping the product properly

You must click the "safly remove hardware " icon on the right of the taskbar, if u want to stop the product and then there a direction telling that the USB Mass storage device can now be safely remvd. then u can whop the USBcable from the USB port and then there appeared a direction telling that the USB Mass storage device can be safely remvd. then u can whop the USBCcable from the USB port"



Other than the spelling and grammatical errors, I had no idea what whopping was. Whopping sounds like something one does when attending a Jerry Springer show. For example "Go Jerry, go Jerry — whop, whop, whop, whop". This example was just a short snippet of the whole manual which I couldn't make heads or tails of.

Alas, the solution was found via a Google search but this was the worst piece of official documentation I've encountered. I am, however, determined to find worse examples of poor documentation and user manuals to share in future installments.

Editor's Picks

Free Newsletters, In your Inbox