[openstack-dev] [nova][all] Architecture Diagrams in ascii art?

Joe Gordon joe.gordon0 at gmail.com
Mon May 11 21:57:48 UTC 2015

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.

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).

So how can we do better then ascii art architecture diagrams?

[0] http://docs.openstack.org/developer/heat/architecture.html
[1] http://docs.openstack.org/developer/keystone/architecture.html
[2] http://docs.openstack.org/developer/nova/devref/architecture.html
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150511/53abdac9/attachment.html>

More information about the OpenStack-dev mailing list