Hacker News new | ask | show | jobs
by m-p-3 1501 days ago
Best way to keep it up-to-date is to make the documentation part of the development workflow.

If you can make the code itself generate a diagram (ie: MermaidJS) that reflect your code, it won't become outdated.

It takes time and effort to get there, so you might want to at least make a manual diagram to understand where you're at before undertaking this kind of automation.