An Interest In:
Web News this Week
- April 2, 2024
- April 1, 2024
- March 31, 2024
- March 30, 2024
- March 29, 2024
- March 28, 2024
- March 27, 2024
You're Continuously Integrating & Continuously Deploying. The time has come to Continuously Document.
I'm Principal Software Engineer at Swimm. A startup building a documentation tool for developers based on the paradigms of Continuous Documentation.
What is continuous documentation
"Continuous documentation is the process of creating and updating documentation incrementally and as part of the development workflow, ensuring it is in sync with the codebase."
The author - who happens to be a good friend of mine - argue for 3 main principles.
Continuous Documentation means that the documentation is:
- Code-coupled
- Always up-to-date
- Created when best
Sounds good in theory, right?
But how does it work in practice?
One way is through Git Checks
Swimm automatically checks any documentation pushed to git to make sure its up to date. If the code mentioned in your documentation changed, Swimm alerts you and lets you address the issue quickly and easily. This way both your code and your documentation are always accurate and up to date.
I invite you to check out Swimm and join our free open beta and I'm happy to chat with anyone from the dev.to community to show them the various use cases for Swimm - for both teams and individuals.
Original Link: https://dev.to/itai/youre-continuously-integrating-continuously-deploying-the-time-has-come-to-continuously-document-jeg
Dev To
An online community for sharing and discovering great ideas, having debates, and making friendsMore About this Source Visit Dev To