4.7 Best-practice rules for documentation
153
4.7.1 Rule 1: Write from the readers’ perspective
153
4.7.2 Rule 2: Avoid unnecessary repetition
154
4.7.3 Rule 3: Avoid ambiguity
154
4.7.4 Rule 4: Standardized organizational structure or templates
154
4.7.5 Rule 5: Justify important decisions in writing
155
4.7.6 Rule 6: Check the documentation’s suitability for use
155
4.7.7 Rule 7: Uncluttered diagrams
155
4.7.8 Rule 8: Regular updates
155
4.7.9 Side Note: Rule 9: Adapt the changeability of the documentation to the architecture
156