[OpenStack-docs] Deprecation of custom semantic markup

Lana Brindley openstack at lanabrindley.com
Mon Oct 12 06:13:04 UTC 2015


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

On 12/10/15 16:11, Andreas Jaeger wrote:
> On 2015-10-12 00:48, Lana Brindley wrote:
>> -----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.
> 
> I was thinking even longer than that, I don't see that we have to make these changes at all,
> 

Yeah, that's a good point. I don't think we need to retroactively go through and 'fix' all these. Just change it going forward.

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/

iQEcBAEBAgAGBQJWG09wAAoJELppzVb4+KUynyIIAJdHlIiRt9t7Tx9WdLPH1KcG
AYhsdMWAyzcPx8gub2bfVeilRvgqT9M+DyqrWPs7/UdPhHzSe8oZNWZ23UkvRWnM
37frGCae9p8r0/cDMN1HjfH2l5qZFmLUcGkNzTQhDGz99vk1Mcg6l2jpgLIfpC1i
yKlQAnsb/DUDWCms69ujLmRH0/9PmEH/oneeGh/nEqAx41c0T4V0CDCb62SVjki9
lCa1TXgnqDKjcxKpLv8KLPYwegLpgjHFSopDhjidAoEij2WpHgs4r8+v332FHoNA
o0JzokOmQ0RgYxUibb5lgscbUF4/UZ8t0YDxtkeAkzZqckSVccAje/HWavAaiAg=
=lMuT
-----END PGP SIGNATURE-----



More information about the OpenStack-docs mailing list