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

Joshua Harlow harlowja at outlook.com
Mon May 11 22:24:23 UTC 2015


Use dia[1] (opensource) or omnigraffle[2] (not free/open) or something 
else (preferable the free/opensource ones)?

[1] http://dia-installer.de/
[2] https://www.omnigroup.com/omnigraffle

Joe Gordon wrote:
> 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
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



More information about the OpenStack-dev mailing list