<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:16px"><div id="yui_3_16_0_1_1433985009719_551493" dir="ltr">checkniceness seems to complain about any line longer than 69 chars --</div><div id="yui_3_16_0_1_1433985009719_551422" dir="ltr">perhaps coded as <70? It's been kind of arbitrary about when Jenkins does a</div><div id="yui_3_16_0_1_1433985009719_551452" dir="ltr">failure -- subtleties of which I'm not aware, it seems, but once it does a FAILURE</div><div id="yui_3_16_0_1_1433985009719_551495" dir="ltr">for a CR, it's adamant about wanting it fixed ;-)</div><div dir="ltr"><br></div><div id="yui_3_16_0_1_1433985009719_551497" dir="ltr">meg<br></div><div id="yui_3_16_0_1_1433985009719_551351"><span></span></div><br> <blockquote id="yui_3_16_0_1_1433985009719_551502" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1433985009719_551501" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1433985009719_551500" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div dir="ltr"> <hr size="1"> <font face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> Lana Brindley <openstack@lanabrindley.com><br> <b><span style="font-weight: bold;">To:</span></b> Meg McRoberts <dreidellhasa@yahoo.com>; "openstack-docs@lists.openstack.org" <openstack-docs@lists.openstack.org> <br><b><span style="font-weight: bold;">Cc:</span></b> Radoslaw Smigielski <radoslaw.smigielski@alcatel-lucent.com> <br> <b><span style="font-weight: bold;">Sent:</span></b> Thursday, June 11, 2015 3:49 PM<br> <b><span style="font-weight: bold;">Subject:</span></b> Re: [OpenStack-docs] RST line length<br> </font> </div> <div id="yui_3_16_0_1_1433985009719_551499" class="y_msg_container"><br>-----BEGIN PGP SIGNED MESSAGE-----<br clear="none">Hash: SHA1<br clear="none"><br clear="none">On 12/06/15 08:43, Meg McRoberts wrote:<br clear="none">> The conventions (<a shape="rect" href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Avoid_long_lines" target="_blank">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Avoid_long_lines</a>)specify a maximum 70 characters per line; currently, checkniceness balks at anything longer than 69 chars.<br clear="none">> I think the recommendation should be 80 chars rather than 70 -- it just seems more "natural" somehowand is still short enough for gerrit displays.<br clear="none"><br clear="none">Hrm, I don't remember noticing that before. I have my editor set at 78<br clear="none">chars, which so far hasn't caused a problem. I'm happy to see the<br clear="none">recommendation changed to 80.<br clear="none"><br clear="none"><br clear="none">> Personally, I favor short lines, broken along natural semantic boundaries (sentences, clauses) rather thanusing the vi facility to just wrap the text arbitrarily but that may be too much for some people.<br clear="none">> checkniceness does allow for programlistings/screens and URLs but it doesn't differentiate tables and I'mnot sure it can. For this reason, I propose that the checkniceness limit be expanded, perhaps to 100. Asan example, check the table in this section:<br clear="none">> <a shape="rect" href="https://review.openstack.org/#/c/188974/8/doc/ha-guide/source/networking-ha-l3.rst" target="_blank">https://review.openstack.org/#/c/188974/8/doc/ha-guide/source/networking-ha-l3.rst</a><br clear="none"><br clear="none">What is it currently, do you know?<div class="qtdSeparateBR"><br><br></div><div class="yqt3601826807" id="yqtfd34979"><br clear="none"><br clear="none">> The first column has some long strings that shouldn't be broken, so I ended up with a third column of 2-4 words,which is annoying and would make it impossible to put a URL or even a full pathname in that column.Worse, after I made these changes, the column widths in the formatted table are not correct -- the first columnends up being much wider than is necessary and the third column has pretty much the very short lines that arein the source.<br clear="none">> In the aforementioned CR, look at patch 5 or earlier to see this table before I had to redo it to placatecheckniceness. <br clear="none">> <br clear="none">> Other opinions?Meg</div><br clear="none">> <br clear="none">> <br clear="none">> <br clear="none">> <br clear="none">> _______________________________________________<br clear="none">> OpenStack-docs mailing list<br clear="none">> <a shape="rect" ymailto="mailto:OpenStack-docs@lists.openstack.org" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br clear="none">> <a shape="rect" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br clear="none">> <br clear="none"><br clear="none"><br clear="none">- -- <br clear="none">Lana Brindley<br clear="none">Technical Writer<br clear="none">Rackspace Cloud Builders Australia<br clear="none"><a shape="rect" href="http://lanabrindley.com/" target="_blank">http://lanabrindley.com</a><br clear="none">-----BEGIN PGP SIGNATURE-----<br clear="none">Version: GnuPG v1<br clear="none"><br clear="none">iQEcBAEBAgAGBQJVehBiAAoJELppzVb4+KUynp8IALqA7GPJO+8cbu2Eez0ooPTI<br clear="none">PCkPKU4Nv0TNkWls0DwYwOFPgWlVmjn+pqn+NFt9RmiA1NWVO7QHlUXI9tqjAbVO<br clear="none">gH88YytskiTt9ifm8XJGAhx+lZADmRqMCGVji5gZFYO9QfDqTjTqw2KnkEE3FHxu<br clear="none">14LUqtFlZFn54q9caD7X5bo1ZZBWuWiI/iO5hsu8GDBJmH/Ko6U48zEQ1/sXGw33<br clear="none">zU1ws7wt44FK/qbS4x8qZwjkgGZ0kwXoBkWEJjP9XSqa2vSYD9UNQxK0yDdhBNRQ<br clear="none">X1GYwIKgJS3VzlN9K+1+rFt+chdeJN5/+ObnsUBMZV9P1/iovT0QY1sk0F40FWQ=<br clear="none">=9A9d<br clear="none">-----END PGP SIGNATURE-----<div class="yqt3601826807" id="yqtfd23391"><br clear="none"></div><br><br></div> </div> </div> </blockquote> </div></body></html>