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 <a...@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-requ...@lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
