Open Stack

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