One thing, possibly less significant than many of the other suggestions here, is the difficulty in improving. If documentation is not done well and thoroughly from the beginning, it makes it difficult to improve later. Rationale and successful improvements cannot…   Read more»