4 ms·
The only thing worse than a big system with no documentation is a big system with documentation that is full of lies and untruths. Short of hiring people full-
by mkozlows 11y ago
The only thing worse than a big system with no documentation is a big system with documentation that is full of lies and untruths.
Short of hiring people full-time to write documentation, and to ensure that all changes to the program are done in a heavyweight-enough process to ensure that documentation changes match the programming changes, those are your two choices.
- bro-stick 11y agoA not as big system decomposed into well-defined parts with clear and concise documentation is best of all. Great documentation hits many purposes including lessening learning curve for training and behavior qualtitative verification without burdening readability by mindlessly duplicating boilerplate that detracts.