<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif;">
<div>On [2], I like the both the Compute Note and (despite injunctions to ignore) the Object Storage nodes (the grey on dark is particularly nice). My only concern with the dark background is that it’s hard to see things like the connector lines from the “100+
GB Storage” block to the /dev blocks.</div>
<div><br>
</div>
<div>On [3], I’ll cast another vote for the Network node scheme.</div>
<div><br>
</div>
<div>General comment with the dark-background blocks: readability of the light-color text might be improved with a heavier line weight. </div>
<div><br>
</div>
<div>All that said: thanks for tackling this, Matt!</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Matt Kassawara <<a href="mailto:mkassawara@gmail.com">mkassawara@gmail.com</a>><br>
<span style="font-weight:bold">Date: </span>Thursday, 13 November 2014 at 19:28<br>
<span style="font-weight:bold">To: </span>"<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><br>
<span style="font-weight:bold">Subject: </span>[OpenStack-docs] Diagram color scheme<br>
</div>
<div><br>
</div>
<div>
<div>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.
<div><br>
</div>
<div>Matt</div>
<div><br>
</div>
<div>[1] <a href="http://ethanschoonover.com/solarized">http://ethanschoonover.com/solarized</a></div>
<div>[2] <a href="http://23.253.231.218/rpc-diagrams/os-examplearchneutron-hw.png">http://23.253.231.218/rpc-diagrams/os-examplearchneutron-hw.png</a></div>
<div>[3] <a href="http://23.253.231.218/rpc-diagrams/os-examplearchneutron-networks.png">http://23.253.231.218/rpc-diagrams/os-examplearchneutron-networks.png</a></div>
</div>
</div>
</span>
</body>
</html>