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?
"Documentation as code" is a nice idea<p>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)
"document"?<p>You <i>MUST</i> be new here :P<p>Sadly, documentation gets relegated so far down the list of priorities that it [effectively] never happens :|