Open Stack

Thanks Andreas, for those links. (I didn't realize there was documentation,
yay!)

Looking through
https://docs.openstack.org/contributor-guide/rst-conv/inline-markups.html,
I only like the output of 'Command' wrt highlighting. No background colour,
no coloured text, just the same black and bolded. I guess I'm just boring
:-(

--ruby

On Wed, Aug 23, 2017 at 2:16 PM, Andreas Jaeger <aj at suse.com> wrote:

> On 2017-08-23 18:30,  Loo, Ruby  wrote:
> > Hi,
> >
> >
> >
> > I was brought up to think that red was one of those colours that people
> > had different (and sometimes really negative) associations with. When I
> > look at our latest and greatest! ironic documentation (e.g. [1]), I see
> > red. Not only do I see red, but the term has a different background
> > colour and is bordered (or whatever it is called). Are we using the
> > wrong .rst syntax, should we be highlighting terms differently? And/or
> > is there some way to change the appearance of highlighted terms? I much
> > prefer something simple, like bold black text in some uniform font. On
> > the other hand, perhaps lots of others like this and I'm in the minority.
> >
>
> Looking at your source code, your html, and at
> https://docs.openstack.org/contributor-guide/rst-conv/inline-markups.html
> - the red is the expected color by the openstackdocstheme.
>
> See also https://docs.openstack.org/openstackdocstheme/latest/
>
>
> > I can handle the Warnings that are in red though. (I'm not sure it is
> > necesary, given that it is all in a BOX with a WARNING SYMBOL.)
> >
> >
> >
> > I hesitated about sending this due to the wonderful bike shedding that
> > could happen, don't disappoint me, cuz I'm sure we all have opinions
> > about colour. :)
>
> Sure, we all have opinions. I think the best way to avoid a bike shed is
> a change that proposes a better colouring scheme. Even is red there
> since the beginning of the theme - so now for 2.5 years - the docs team
> takes changes to have less colour issues ;)
>
> Andreas
> --
>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
>   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
>        HRB 21284 (AG Nürnberg)
>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170824/4173e687/attachment.html>