The Mythical Man Month

The Other Face is a chapter which tries to explain what good documentation looks like. Brooks describes nine principles which should guide the programmer to write a useful description. I won’t cite them here, but what is more interesting is that he suggests that it is imperative the coder writes the documentation before starting to code.