[OpenStack-docs] RST line length
Anne Gentle
annegentle at justwriteclick.com
Fri Jun 12 13:36:49 UTC 2015
On Fri, Jun 12, 2015 at 8:28 AM, Andreas Jaeger <aj at suse.com> wrote:
> On 06/12/2015 08:16 AM, Andreas Jaeger wrote:
>
>> On 06/12/2015 12:55 AM, Meg McRoberts wrote:
>>
>>> checkniceness seems to complain about any line longer than 69 chars --
>>> perhaps coded as <70? It's been kind of arbitrary about when Jenkins
>>> does a
>>> failure -- subtleties of which I'm not aware, it seems, but once it does
>>> a FAILURE
>>> for a CR, it's adamant about wanting it fixed ;-)
>>>
>>
>> The current limit should be 79 characters for RST files (that's doc8's
>> default), if it's not we can change it to use that value (or any other
>> as desired).
>>
>
> First cleanup patch:
> https://review.openstack.org/191067
>
> If you want to help, just change the value in tox.ini and fix files.
Thanks Andreas - I just commented on the patch that I want us to avoid
tables when possible, especially two-column ones that can be written as
definition lists. Tables are not always the right answer for information
and when they're difficult to create and maintain I think it's a better
choice to use another format when we can.
Thanks,
Anne
>
>
> Andreas
>
>
> Note that we disabled the line length check for openstack-manuals since
>> it caused some problems during the User Guide RST conversion. Patches to
>> enable it again are welcome,
>>
>> Andreas
>>
>
>
> --
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
> SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,
> HRB 21284 (AG Nürnberg)
> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
--
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150612/c17ad550/attachment.html>
More information about the OpenStack-docs
mailing list