<div dir="ltr">A good chunk of the existing diagrams were made in OmniGraffle... mostly because it provides the path of least resistance in terms of time and effort to generate useful diagrams. The documentation build system uses PNG files, a raster format, so we request that any diagrams also include an editable vector version in a separate file, typically something relatively open such as SVG. However, as it turns out, no diagram tool seems to agree on SVG file format, so it often helps to include a third file of the diagram in the native format. The next problem we face is how to instruct new people to make diagrams that conform to some sort of usable standard. Not as easy as words, and explanations of things like line width or shading often depend on the particular application. So, during the Newton cycle, we'd like to determine how to define standards for diagrams and then add them to the contributor guide. </div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, May 12, 2016 at 11:53 AM, Nate Archer <span dir="ltr"><<a href="mailto:Nate.Archer@rackspace.com" target="_blank">Nate.Archer@rackspace.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">



<div style="word-wrap:break-word;color:rgb(0,0,0);font-size:14px;font-family:Calibri,sans-serif">
<div>Shaun:</div>
<div><br>
</div>
<div>My name is Nate Archer. I’m an information developer at Rackspace looking to become more involved with Openstack. </div>
<div><br>
</div>
<div>Lana Brindley and Darren Chan gave me your name. During the docs planning at Summit, you discussed putting together some diagram recommendations for the Openstack contributor guides. Also in this discussion was Olga, Linnete, Piet, and Matt.</div>
<div><br>
</div>
<div>I’m starting this email thread as a way of beginning the conversation about diagrams.</div>
<div><br>
</div>
<div>As a newbie to Openstack, I would really love to see an updated version of the Logical Architecture diagram for the Ironic contributor guide. </div>
<div><br>
</div>
<div>Do you have any ideas or thoughts? </div>
<div><br>
</div>
<div>Regards,</div>
<div><br>
</div>
<div>Nate Archer</div>
<div>Information Developer I</div>
<div><a href="mailto:Nate.archer@rackspace.com" target="_blank">Nate.archer@rackspace.com</a></div>
<br>
</div>

<br>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br></div>