On Thu, Oct 18, 2012 at 11:56 AM, Joe Brockmeier <[email protected]> wrote: > On Thu, Oct 18, 2012 at 10:03:46AM -0500, Joe Brockmeier wrote: >> On Thu, Oct 18, 2012 at 10:51:15AM -0400, David Nalley wrote: >> > That said, our Java coding standards says lines shouldn't be more than >> > 80 chars: >> > http://docs.cloudstack.org/CloudStack_Documentation/Design_Documents/Coding_Conventions#Files.2C_Layout_and_whitespace >> >> Sure, but this isn't Java. If you look at, for instance, the upstream >> Publican docs: >> >> http://git.fedorahosted.org/cgit/publican.git/tree/publican/Users_Guide/en-US > > Argh - didn't finish the thought. > > If you look at other projects using DocBook/Publican, they typically > don't hard-wrap docs to adhere to programming language guidelines.
I'll take that as anecdotal. Docbook the Definitive Guide shows a counter example: http://www.docbook.org/tdg5/en/html/para.html Additionally Gnome (which I rarely call out as an example, but...) seems to use the same standard. http://developer.gnome.org/gdp-handbook/stable/docbook.html.en#docbook-section
