<div dir="ltr"><div><div>When learning about how a project works one of the first things I look for is a brief architecture description along with a diagram. For most OpenStack projects, all I can find is a bunch of random third party slides and diagrams.</div></div><div><br></div><div>Most Individual OpenStack projects have either no architecture diagram or ascii art. Searching for 'OpenStack X architecture' where X is any of the OpenStack projects turns up pretty sad results. For example heat [0] an Keystone [1] have no diagram. Nova on the other hand does have a diagram, but its ascii art [2]. I don't think ascii art makes for great user facing documentation (for any kind of user).</div><div><br></div><div>So how can we do better then ascii art architecture diagrams?</div><div><br></div><div>[0] <a href="http://docs.openstack.org/developer/heat/architecture.html">http://docs.openstack.org/developer/heat/architecture.html</a><br></div><div>[1] <a href="http://docs.openstack.org/developer/keystone/architecture.html">http://docs.openstack.org/developer/keystone/architecture.html</a></div><div>[2] <a href="http://docs.openstack.org/developer/nova/devref/architecture.html">http://docs.openstack.org/developer/nova/devref/architecture.html</a></div></div>