I was wondering how do people documenting or visualising a microservices architecture. Do you use a particular tool? If you do versioning, how do you keep compatibility notes? Something else you are using?
Cloudcraft has some pretty output for diagrams.<p><a href="https://cloudcraft.co/" rel="nofollow">https://cloudcraft.co/</a><p><a href="https://news.ycombinator.com/item?id=10722942" rel="nofollow">https://news.ycombinator.com/item?id=10722942</a>
Caution: You may find this irrelevant: When I was working at Amazon, I had attended a tech talk in which the speakers discussed about how they had tried to build a tool to visualize service dependencies within Amazon (It was a fun side project for them). The issue they faced was that there were just too many services and an attempt to display all the services, even on a large monitor just resulted in a large black mass (or white mass on a black background, don't really remember) that conveyed zero useful information.