Ask HN: Tool to create visual flowcharts/documentation from code comments
Say a new feature is being developed and the team draws up a flowchart of user or data flow. This will most likely be done in a tool like Confluence, Google Docs, Whimsical etc. However, it will probably get outdated pretty quickly as the team starts writing code (things change). The context also lives completely outside and divorced from the source of truth in code. I've worked in a number of teams over the years where the technical specs are horribly outdated and there's almost no point reading them to get an understanding of how something works.
I've been thinking of building a tool that enables developers to create documentation that is accessible to everyone, but from within code. The main problem it solves is linking documentation to actual implementation details. This is often very useful when debugging something or when on-boarding new developers. But more importantly, it would mean fewer docs are out of date. They're front and center in a place where engineers spend a large portion of their day.
Would this be of value to you? Does it already exist?