<font size=2 face="sans-serif">The Keystone team actually uses ascii diagrams
in some of our specs, [0] for instance.</font>
<br><font size=2 face="sans-serif">I might be in the minority here, but
I actually like them and find the easy to create and read.</font>
<br>
<br><font size=2 face="sans-serif">[0] </font><a href="http://specs.openstack.org/openstack/keystone-specs/specs/kilo/websso-portal.html"><font size=2 color=blue face="sans-serif">http://specs.openstack.org/openstack/keystone-specs/specs/kilo/websso-portal.html</font></a>
<br>
<br><font size=2 face="sans-serif"><br>
Thanks,<br>
<br>
Steve Martinelli<br>
OpenStack Keystone Core</font>
<br>
<br><tt><font size=2>Joe Gordon <joe.gordon0@gmail.com> wrote on
05/11/2015 05:57:48 PM:<br>
<br>
> From: Joe Gordon <joe.gordon0@gmail.com></font></tt>
<br><tt><font size=2>> To: OpenStack Development Mailing List <openstack-dev@lists.openstack.org></font></tt>
<br><tt><font size=2>> Date: 05/11/2015 05:59 PM</font></tt>
<br><tt><font size=2>> Subject: [openstack-dev] [nova][all] Architecture
Diagrams in ascii art?</font></tt>
<br><tt><font size=2>> <br>
> When learning about how a project works one of the first things I
<br>
> look for is a brief architecture description along with a diagram.
<br>
> For most OpenStack projects, all I can find is a bunch of random <br>
> third party slides and diagrams.</font></tt>
<br><tt><font size=2>> <br>
> Most Individual OpenStack projects have either no architecture <br>
> diagram or ascii art. Searching for 'OpenStack X architecture' where<br>
> X is any of the OpenStack projects turns up pretty sad results. For
<br>
> example heat [0] an Keystone [1] have no diagram. Nova on the other
<br>
> hand does have a diagram, but its ascii art [2]. I don't think ascii<br>
> art makes for great user facing documentation (for any kind of user).</font></tt>
<br><tt><font size=2>> <br>
> So how can we do better then ascii art architecture diagrams?</font></tt>
<br><tt><font size=2>> <br>
> [0] </font></tt><a href=http://docs.openstack.org/developer/heat/architecture.html><tt><font size=2>http://docs.openstack.org/developer/heat/architecture.html</font></tt></a>
<br><tt><font size=2>> [1] </font></tt><a href=http://docs.openstack.org/developer/keystone/architecture.html><tt><font size=2>http://docs.openstack.org/developer/keystone/architecture.html</font></tt></a>
<br><tt><font size=2>> [2] </font></tt><a href=http://docs.openstack.org/developer/nova/devref/architecture.html><tt><font size=2>http://docs.openstack.org/developer/nova/devref/architecture.html</font></tt></a><tt><font size=2><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe<br>
> </font></tt><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev"><tt><font size=2>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</font></tt></a><tt><font size=2><br>
</font></tt>