3 ms·
I've had this vague idea about what to do if I'm ever in charge of a project. How well would it work to put documentation in with the source, not just doc comme
by andrewflnr 13y ago
I've had this vague idea about what to do if I'm ever in charge of a project. How well would it work to put documentation in with the source, not just doc comments but standalone, and not pass a commit for review unless it has appropriately updated documentation? Maybe an emergency valve for tight deadlines, or turn it off for hotfixes generally. Besides the obvious dependence on some degree of discipline, what are the main problems? I feel like if I actually tried this, it would blow up in some unexpected way.