The Importance of Documentation

As PM&M we spend a huge part of our working day communicating both internally and externally. Despite this, we often get far into a product process and discover that somehow we don't have documentation or that we have very poor documentation. It may not, therefore, come as a complete surprise that we have a poor product definition and a weak customer engagement.

Sure, our creative skills and leadership mission don't leave much time for hacking away producing long word documents, but, as we will discuss in this post good functional documentation is an essential part of our mission and the craft, that can help or hinder the overall business success.

We welcome a guest blogger - Larry Lester - A Sales & Marketing Documentation Guru to discuss

There’s a host of reasons why small, emerging companies (aka start ups) should take documentation seriously. The problem is that most of those that I have worked with – don’t.

First and foremost they should take it seriously for all the reasons that larger companies take it seriously – it is a way of keeping your marketing, development, operations, and sales efforts – and the also the customer – in alignment.

However, for a start up the lack of good technical and marketing documentation – with the emphasis on good, or not having something basic at least – makes survival more perilous than usual. My phone usually starts ringing when these guys are about to crash land. If they have had the good fortune to make a sale, the customer is being nasty and delaying a milestone payment because a full set of technical documentation was supposed to be delivered and has not even been written. Or, if they have only got their foot in the door, discussions are about to collapse as the only marketing material they have to give to potential customers are a few pages of incomprehensible gibberish and a dreadful PowerPoint presentation! “We thought we could pull it off”.

The situation is, in fact, more serious than that. A company that does not maintain product requirement documentation is openly toying with suicide. There are two aspects to this assertion.

1. Poorly documented development is bound to result in a bug-ridden product. If you don’t write about it (requirements) then you don’t talk about it, and if you don’t talk about it, you brush aside the problems. Lack of a standard process and workflow causes product decisions to be made in an ad hoc way. At best, it is inefficient. At worst, it will kill your efforts to make a sale.
2. A good product requirement or a spec can serve as the basis for installation, operation and maintenance documentation. The saving in time, energy and money can be substantial. Somewhere down the road, you will need a technical writer, whether you like it or not. The more solid information you have to provide, the easier your lives will be.

The bottom line: give both technical and marketing documentation the same priority you give to development and sales. All of these processes are fully entwined - together the product should succeed; without any one of them it will be a struggle and potentially a product failure.