[OpenStack-docs] Diagram recommendations for Openstack Contributor Guides

Nate Archer Nate.Archer at rackspace.com
Fri May 13 14:28:06 UTC 2016


What is everyone's thoughts on Draw.io<https://www.draw.io/>? I've used in the past and while the toolset is somewhat limited, it has the ability to save and open editable SVG's, as well as the ability to export the diagram as a PNG file.

Downside is when you open an SVG file in Draw.io that has been created in another tool, certain elements of the illustration might not show up. This problem is mitigated if you use Draw.io exclusively, as with any software.

As Darren and Matt have pointed out, Inkscape is cumbersome to use, and has many of the same problems as Draw.io, without any of the strengths.

-Nate

From: Matt Kassawara <mkassawara at gmail.com<mailto:mkassawara at gmail.com>>
Date: Friday, May 13, 2016 at 7:36 AM
To: Christian Berendt <christian at berendt.io<mailto:christian at berendt.io>>
Cc: Olga Gusarenko <ogusarenko at mirantis.com<mailto:ogusarenko at mirantis.com>>, Shaun OMeara <shaun at omeara.co.za<mailto:shaun at omeara.co.za>>, "someara at mirantis.com<mailto:someara at mirantis.com>" <someara at mirantis.com<mailto:someara at mirantis.com>>, "openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>" <openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>>, Rackspace Hosting <Nate.Archer at rackspace.com<mailto:Nate.Archer at rackspace.com>>, Darren Chan <darren.chan at RACKSPACE.COM<mailto:darren.chan at RACKSPACE.COM>>
Subject: Re: [OpenStack-docs] Diagram recommendations for Openstack Contributor Guides

If you contribute diagrams, you'll quickly figure out that Inkscape is difficult to use and produces rough content at best. If we want OpenStack to appear more professional and less like a science experiment to our increasingly less technical (read: decision makers) audience, we have to use a tool that creates professional looking content. Some of the online tools are surprisingly decent, so I wouldn't rule them out. Unfortunately, regardless of what we use, we're never going to have standardized SVGs that any online or installed tools can consistently parse.

On Fri, May 13, 2016 at 3:46 AM, Christian Berendt <christian at berendt.io<mailto:christian at berendt.io>> wrote:
On 13 May 2016 at 10:34:48, Shaun OMeara (shaun at omeara.co.za<mailto:shaun at omeara.co.za>) wrote:
> > Opensource

With this requirement we are only able to use Inkscape, it is the only listed open source software.

Omnigraffle, DrawSVG, and Lucidchart are not open sourced.

I would prefer to not rely on hosted services like Lucidchart and DrawSVG. This way we are depending on the availability of a 3rd party service provider.

Christian.

--
Christian Berendt


_______________________________________________
OpenStack-docs mailing list
OpenStack-docs at lists.openstack.org<mailto:OpenStack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160513/af30fb6e/attachment.html>


More information about the OpenStack-docs mailing list