The Keystone team actually uses ascii diagrams in some of our specs, [0] for instance. I might be in the minority here, but I actually like them and find the easy to create and read. [0] http://specs.openstack.org/openstack/keystone-specs/specs/kilo/websso-portal.html Thanks, Steve Martinelli OpenStack Keystone Core Joe Gordon <joe.gordon0 at gmail.com> wrote on 05/11/2015 05:57:48 PM: > From: Joe Gordon <joe.gordon0 at gmail.com> > To: OpenStack Development Mailing List <openstack-dev at lists.openstack.org> > Date: 05/11/2015 05:59 PM > Subject: [openstack-dev] [nova][all] Architecture Diagrams in ascii art? > > 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 -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150511/7ce67ff6/attachment.html>