Check out About Bad Instructions by rogersgeorge. Here is an excerpt:
I have a motto on my wall that reads
Bad documentation must never be justified
with the excuse that
the reader will figure it out.
This post first appeared on The Writing Rag.
The full article is available here.