I gleaned another nugget of writing wisdom from my recent flooring project, and that is the difficulty of finding decent instructions.
I spent a lot of time looking around the web for advice on how to install laminate flooring. I found quite a bit and it was helpful, but I consistently ran into the problem of steps that weren't well enough explained. For example, you have to use spacers to leave a gap between the floor and the wall to allow expansion. However not one how-to article mentioned
how the heck to keep the little buggers from falling over all the time! Every person I've talked to who has done laminate flooring had the same problem. All of us ended up just not using the spacers and hoping for the best.
When writing instructions, it's tricky to know the level of your audience. In a case like this, it is likely that the person needs explanations of even simple concepts. These instructions are generally written by people with a lot of experience and they tend to omit things that have become second nature to them.
I'm not immune to this. Once I was training a couple of employees. I was explaining that they needed to click on the such-and-such icon to start the software. This one woman looked absolutely baffled until the other one leaned over and said, "Icons are the little pictures on your screen," and the light dawned. It never occurred to me to explain the term, but it's not like we come out of the womb knowing what "icon" means.
The whole point to writing for the web is hypertext. That means you can give basic instructions with links to in-dept explanations for each step, definitions of words and acronyms, pages of tips, lists of tools needed, and anything else you can think of. That's the whole point of hypertext.
Of course, I realize these articles aren't written with that in mind. These are probably the "I need someone to write 500 words on how to install laminate flooring" types of projects with no real attempt to make use of the strengths of the web.
It's the cool thing nowadays to trash
Wikipedia, but that is a good example of a hypertext document done right. Every article contains link after link, embedded in the main text, to allow the reader to explore every angle of a subject. It's great, unless you get caught up on one of those stream-of-consciousness explorations while you are supposed to be researching an article.
In a perfect world, every how-to article would actually link to a massive database of information, allowing readers to decide for themselves the depth of explanation they need. Then again, Wikipedia works because it has several gazillion people working to maintain it and most sites don't have that level of support. Still, I would think some sites dedicated to home improvement (or any other subject) would set up a more heavily cross-linked database.