Archive for March 19, 2018

What is the subject of this document?

Probably the most common problem that I see in technical documentation is a failure to say upfront what the thing is that you’re documenting. I feel that in most cases, one of the first pages of the documentation set should have a sentence early on in the page that says something like “[Product name] is […]