I’ve been using DiagramDeck (a browser-based diagramming tool with draw.io compatibility) to create architecture diagrams, flowcharts, and some UML diagrams for our team.

So far it’s been working well, especially for real-time collaboration, but I’m curious about best practices when working with diagrams at scale.

For teams that actively create and maintain multiple diagrams:
- how do you organize diagrams (by service, feature, environment, etc.)?
- do you keep separate diagrams for high-level vs detailed architecture?
- how do you approach updating diagrams as systems evolve?

I’m mostly interested in general workflows that work well in collaborative diagramming tools.

Any tips or examples would be really helpful.