<div dir="ltr"><div>Developers can handle ASCII. Developers can't handle steel blue versus cornflower blue.</div><div><br></div><div>But seriously, graphics collaboratively authored by developers should, ideally, be editable via a text file. Otherwise they won't be maintained.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 12, 2015 at 8:31 PM, Devananda van der Veen <span dir="ltr"><<a href="mailto:devananda.vdv@gmail.com" target="_blank">devananda.vdv@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><p dir="ltr">Woops. I missed most of this thread in my last reply.</p>
<p dir="ltr">I'm all for using open standard formats and versioning them. However. Not being a graphical artist myself, I have found the learning curve on some of those tools daunting, eg. inkscape, which means I'm far less likely to update a graphic in a format that requires me to go learn that tool first. Also, it's awkward to require a Python developer to update an SVG because that is "documentation" affected by their commit.</p>
<p dir="ltr">If we go with a common tool/format like libre office/ODF. I suggest we adopt some commonalities, and still keep things simple enough that we can reasonably expect any developer to update it.</p><span class="HOEnZb"><font color="#888888">
<p dir="ltr">-D</p></font></span><div class="HOEnZb"><div class="h5">
<div class="gmail_quote">On May 12, 2015 12:33 PM, "Sean Dague" <<a href="mailto:sean@dague.net" target="_blank">sean@dague.net</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 05/12/2015 01:12 PM, Jeremy Stanley wrote:<br>
> On 2015-05-12 10:04:11 -0700 (-0700), Clint Byrum wrote:<br>
>> It's a nice up side. However, as others have pointed out, it's only<br>
>> capable of displaying the most basic pieces of the architecture.<br>
>><br>
>> For higher level views with more components, I don't think ASCII art<br>
>> can provide enough bandwidth to help as much as a vector diagram.<br>
><br>
> Of course, simply a reminder that just because you have one or two<br>
> complex diagram callouts in a document doesn't mean it's necessary<br>
> to also go back and replace your simpler ASCII art diagrams with<br>
> unintelligible (without rendering) SVG or Postscript or whatever.<br>
> Doing so pointlessly alienates at least some fraction of readers.<br>
<br>
Sure, it's all about trade offs.<br>
<br>
But I believe that statement implicitly assumes that ascii art diagrams<br>
do not alienate some fraction of readers. And I think that's a bad<br>
assumption.<br>
<br>
If we all feel alienated every time anyone does anything that's not<br>
exactly the way we would have done it, it's time to give up and pack it<br>
in. :) This thread specifically mentioned source based image formats<br>
that were internationally adopted open standards (w3c SVG, ISO ODG) that<br>
have free software editors that exist in Windows, Mac, and Linux<br>
(Inkscape and Open/LibreOffice).<br>
<br>
        -Sean<br>
<br>
--<br>
Sean Dague<br>
<a href="http://dague.net" target="_blank">http://dague.net</a><br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div>
</div></div><br>__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div><br></div>