[OpenStack-docs] Deprecation of custom semantic markup

Lana Brindley openstack at lanabrindley.com
Sun Oct 11 22:48:07 UTC 2015


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 12/10/15 03:22, Andreas Jaeger wrote:
> On 09/25/2015 11:46 PM, Steve Gordon wrote:
>> ----- 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.
> 
> 
> I also suggest we do not take mass cleanups for these changes. If either form is fine, then no need to change them.
> 
> Especially as this will break all translations for existing content for no change in content at all. We should be friendly to the translators and help them,

Agreed. Let's hold off on changes like this until after Liberty, please.

L

- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJWGucnAAoJELppzVb4+KUyhBEH/0SPcXRi9lVGqKZ3uE3yzp7x
flxxKBKF2rZCg++RTuI6x39dtl/6klgOQilhOSCt1Va3kqP41BgWbuzCbin6oBoG
aY0jL5vtPaXEHUA754UAurCNxqUiztCwiXunoB4cPtOzFGT3SvXEhUpvfFSmK5Wx
+dYvGU5Qq1mKGhmZQIClyu/oEtIK7Mq2qy9qBTl8JwrpvMSAP1+Rhy1GiyTkwxdp
T39rxKTtx11ulWUnBMqBieLmvisLVd0/pV3gOzFV2Y1submetR6outjjzzH/u9f8
OX5uEGsGB+ZgU63wzRNZhUGjQ3H9zHljFTD9luAl8dFmmjtmtOo6TSLL2phYFWw=
=qBdG
-----END PGP SIGNATURE-----



More information about the OpenStack-docs mailing list