[OpenStack-docs] Deprecation of custom semantic markup

Steve Gordon sgordon at redhat.com
Fri Sep 25 21:46:09 UTC 2015


----- Original Message -----
> From: "Andreas Jaeger" <aj at suse.com>
> To: "Matt Kassawara" <mkassawara at gmail.com>
> 
> On 09/25/2015 06:27 PM, Matt Kassawara wrote:
> > Doh, bad word choice. How about... lesser semantic markup that adds
> > complexity to the code without appreciable benefit to our audience in
> > the output.
> >
> 
> What about the following (and feel free to enhance that list):
> 
> We have no preference for :file:`some-file` or ``some-file``, both
> options will be accepted and neither gets a -1.
> 
> Andreas

I'd be +1 on this, I can't for the life of me remember all the possible variants and as Matt pointed out they have zero impact positive or otherwise on what we ultimately present to the reader.

-Steve



More information about the OpenStack-docs mailing list