On the writing of adequate technical documentation