2016-09-25, 09:15 PM
What would all you gear heads do with your time if you actually put together a User's Manual. Almost none of the stuff I've had to search for or ask about was very intuitive. I've tried some things that ended up being one step forward and two or three steps back, so I'm a ;little leery about trying something without some instruction.
Heck, many of them can't even be bothered to write comments within their code. There are many software wiki's on the internet that are years out of date and some have almost zero bearing on the current version of the related software. Now add the problem that writing documentation that nearly anyone can follow is far more difficult than you might think. It is VERY difficult for some people to step all the way back to the beginning and write documentation from the standpoint of someone that doesn't already have an excellent grasp of the subject matter. Just how much can the writer assume that the reader already knows? Did the reader just buy their first computer or perhaps have never done anything with a computer other than surf the web and read email? Or is the reader a tinkerer that has spent years writing and testing batch files and really knows their way around the OS? Keep it too simple and the experienced readers will complain. Make it too advanced and you lose the readers that just see "Blah, blah, blah when they read it. 