Open Stack

In [2], I prefer the Compute node, and in [3], I prefer the Network node color scheme. The font color for the node labels could be lighter so it is easier to read.

This is a good step towards having some consistency with diagrams in the upstream docs. When this is finalized, can we add this information to the documentation conventions wiki, and include other conventions such as file formats, graphics resolution and size, and recommended tools? It would also be helpful to have some guidelines about creating different diagrams, such as network architecture diagrams and process flow diagrams.


Regards,

Darren 





On Friday, 14 November 2014, 12:50, Nick Chase <nchase at mirantis.com> wrote:
 


On the color, I definitely prefer the light version; much easier to read.  Any of the colors actually work, I think.

On the monotone, I actually LIKE the object storage nodes the best,
    though that's not saying much; I don't like the monotone much at
    all, actually, particularly compared with the color.  At small font
    sizes, I don't tink there's enough contrast on the baqckground
    colors.  The content colors are good, though.  That's why the Object
    Storage nodes work, I think.  (Still prefer the color/light version,
    though.)

Nice job finding this.

----  Nick



On 11/13/2014 8:28 PM, Matt Kassawara wrote:

Needless to say, our existing diagram color schemes vary by document and sometimes look rather hideous. For example, I used the red-green-blue theme in the installation guide to improve contrast among the networks, but it lacks the civility you would find in other professional documentation. Similar to networking, colors are hard. For example, themes that implement many shades of one or two colors look professional but limit the ability to contrast important items. On the other hand, themes that implement many diverse colors offer many ways to contrast important items, but look harsh. I haven't found a theme that provides a decent balance until Robb Romans (a coworker at Rackspace) pointed out the Solarized theme [1] today. Although somewhat optimized for text, this theme provides several decent dark/light combinations for diagrams requiring less contrast and a series of diverse yet soft colors for diagrams requiring more contrast. After messing around a
 bit, I came up with a few potential color variants using this theme. Please review the dark/light example for simple diagrams [2] and the diverse color example for complex/contrasty diagrams [3] and provide comments. For the first diagram, indicate which of the controller node, network node, compute node, and block storage node objects look the best (ignore the object storage nodes). For the second diagram, indicate which of the nodes (dark/light) and network colors look best. You can also reject this theme completely. However, if you do, please provide one or more suitable alternatives. I would like to upload a series of revitalized diagrams to the installation guide as soon as possible. 
>
>
>Matt
>
>
>[1] http://ethanschoonover.com/solarized
>[2] http://23.253.231.218/rpc-diagrams/os-examplearchneutron-hw.png
>[3] http://23.253.231.218/rpc-diagrams/os-examplearchneutron-networks.png
>
>
>_______________________________________________
OpenStack-docs mailing list OpenStack-docs at lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs 


_______________________________________________
OpenStack-docs mailing list
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/20141114/e89f7516/attachment.html>