[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