<div dir="ltr"><div></div><div>Hello, Nate!<br></div><div>Thanks for raising the point, and welcome to docs!<br><br>+ Linette Williams to the discussion. Linette, you probably have something to contribute here.<br><br></div><div>As we discussed with Saun and the team on the Summit, the initial plan is as follows:<br><ol><li>Create the templates for the diagrams (a set of images one can construct anything they want using them).</li><li>Found the tool(s) one could import the templates to it and use it for free.</li><li>Add the diagram recommendations to the contributor guide.</li><li>[future] Revise the existing diagrams.</li></ol><p>I can think of quite a big number of questions to discuss, argue =), and agree upon, and it makes sense to create a spec for this.<br></p><p>What do you think?<br></p><ol></ol></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, May 13, 2016 at 12:17 AM, Matt Kassawara <span dir="ltr"><<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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"><div><div class="h5">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></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5">



<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></div></div>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">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>
<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><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div><span style="color:rgb(102,102,102)">Best regards,<br></span></div><span style="color:rgb(102,102,102)">Olga Gusarenko<br><br></span></div><span style="color:rgb(102,102,102)">Technical Writer<span><span> | Mirantis, Kharkiv | 38, Lenin av., Kharkiv, Ukraine<br></span></span></span><div><span style="color:rgb(102,102,102)"><a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.com</a> <span><span>| </span></span>skype: gusarenko.olga <span><span>| +38 (050) 843-14-25</span></span><span><span></span></span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>
</div>