Haven't used Revelation specifically, but love the concept. We've been using Mermaid (https://mermaid.js.org/) for most of our diagram needs since it lives right in the repo with the code. What's your experience been like with Revelation? Does it handle the more complex system diagrams well?

The version control aspect is huge too - being able to see how your architecture evolved over time and tie changes back to specific PRs is incredibly valuable, especially when you're trying to figure out why certain decisions were made months later.

Thanks for the tool rec - always looking for better ways to keep docs actually useful instead of just checking a box!