Doing some research to see if there is a better way to document software projects given detailed design docs are usually: 1. out of date basically immediately, 2. hard to update and keep in sync with the latest project developments. Have you encountered any approaches along your career that you favor for addressing these issues?
Architecture diagrams that can be versioned-controlled using the same VCS as code is a great idea. I've grown fond of mermaid.js recently (it renders natively in GitHub)
