from Hacker News

Ask HN: How does your company maintain documentation about architecture?

by db1 on 12/6/22, 7:39 AM with 0 comments

I work at a large company with hundreds of microservices. There are numerous architecture diagrams distributed across different wiki pages. These are often outdated or wrong. There's no good way to search for the architecture of a component. It's not easy to tell at a glance what other services a service interacts with.

Would love to hear if any company has really nailed a system for how to produce, maintain and organize this data.

Are there any tools that help create a master architecture diagram? Something that can you zoom into to see details at different levels?