I suggest you generate diagrams from Azure Resource Manager (ARM) templates similar to ArmViz.io
Allow the generation of Vision Diagrams from ARM Templates. Ideally this would be via the command line so that this could be automated as part of the continuous delivery pipeline. Other tools like http://armviz.io allow the visualization of templates, but don't allow the saving or exporting of the diagram. The Developer Tools team is also looking at a similar solution. You guys/gals should talk. This would allow solution engineers and architects to generate diagrams from templates, reducing the burden to create Minimum Viable Documentation.
storing diagrams as text is highly needed to for our documentation as code initiative. (similar to plantuml, draw.io, etc.)
Yep, definitely, I had the same idea. On the opposite, having ARM code generated from your visio file would be awesome as well.
I so agree with that idea.