2 ms·
This. There's an almost inevitable orchestration involved in maintaining good documentation for a fast-moving codebase. Tools like Swagger[1] are good for autom
by abhishekpathak 9y ago
This. There's an almost inevitable orchestration involved in maintaining good documentation for a fast-moving codebase. Tools like Swagger[1] are good for automatically generating API documentation, but beyond that there is little help for maintaining generic README-style documentation.
How do large, fast moving projects like the linux kernel manage this?
[1]: https://swagger.io/ https://swagger.io/
- mjw1007 9y agoLinux delegated its user-facing documentation to third parties pretty much from the beginning. Even for those things which have documentation in Documentation/, there is no formal or informal rule that if you make a change which causes existing statements to become false you have to update them.