Open Stack

On Fri, Nov 14, 2014 at 6:24 AM, darren chan <dazzachan at yahoo.com.au> wrote:

> 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.
>
>
>
+1 to all of this, thanks Matt for working on it.


> 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 listOpenStack-docs at lists.openstack.orghttp://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
>
>
>
> _______________________________________________
> 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/6653b161/attachment-0001.html>