[openstack-dev] [nova][all] Architecture Diagrams in ascii art?

Sean Dague sean at dague.net
Tue May 12 19:33:13 UTC 2015


On 05/12/2015 01:12 PM, Jeremy Stanley wrote:
> On 2015-05-12 10:04:11 -0700 (-0700), Clint Byrum wrote:
>> It's a nice up side. However, as others have pointed out, it's only
>> capable of displaying the most basic pieces of the architecture.
>>
>> For higher level views with more components, I don't think ASCII art
>> can provide enough bandwidth to help as much as a vector diagram.
> 
> Of course, simply a reminder that just because you have one or two
> complex diagram callouts in a document doesn't mean it's necessary
> to also go back and replace your simpler ASCII art diagrams with
> unintelligible (without rendering) SVG or Postscript or whatever.
> Doing so pointlessly alienates at least some fraction of readers.

Sure, it's all about trade offs.

But I believe that statement implicitly assumes that ascii art diagrams
do not alienate some fraction of readers. And I think that's a bad
assumption.

If we all feel alienated every time anyone does anything that's not
exactly the way we would have done it, it's time to give up and pack it
in. :) This thread specifically mentioned source based image formats
that were internationally adopted open standards (w3c SVG, ISO ODG) that
have free software editors that exist in Windows, Mac, and Linux
(Inkscape and Open/LibreOffice).

	-Sean

-- 
Sean Dague
http://dague.net



More information about the OpenStack-dev mailing list