When Aaron and I worked at The Company That Shall Not Be Named, the technical publications group was under the umbrella of the sales department. Yes, you read that correctly. And it wasn’t a case of the company being so small that tech pubs didn’t fit under any other group — this was a huge, multinational firm.

Being part of sales meant that the technical publications group was expected to make money. Which was a completely foolish notion. Unless you’re selling hard copy manuals and people are buying them, there’s no way that documentation will make a company money. On paper, the technical publications group was a cost centre; we didn’t make money and therefore our budget was pretty low. We couldn’t get licenses for the tools that we needed to do our jobs, and even attending conferences or taking training was out of the question.

Unfortunately, that view of documentation is incredibly short sighted. The true value of documentation, and the people who create it, is not how much money it makes a company but how much money it saves the company. Documentation doesn’t just explain how to use a product. It’s the first line of support for many customers.

Good documentation — whether a manual, a help file, a wiki, or a knowledge base — enables a user to solve a problem for themselves, rather than make a costly support call. It saves money by allowing support personnel to focus their attention and energies on the more difficult problems that users may encounter; ones that aren’t or can’t be covered in the documentation.

Even more than that, good documentation can be a sales tool. In a couple of cases, the documentation that I wrote was mentioned favourably in software reviews — as an effective guide to configuring and using the applications, and also as a guide to the capabilities of the software. When I left one company, a salesperson made a point of mentioning that the user guide helped him better understand the software, which helped close a couple of sales.

What’s your experience in this area? Feel free to leave a comment.

  • Share/Bookmark

Related posts:

  1. Documentation and its hidden power
  2. Measuring the ROI of documentation
  3. Making a change, or not …