Re: "One sentence per line"

Dylan Jay <dylan-Q+/Sk2sTzaxWk0Htik3J/[email protected]> Thu, 12 Apr 2012 08:01:04 +1000
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <8514670034186668180@unknownmsgid>
On 11/04/2012, at 6:10 PM, Jean Jordaan <[email protected]> wrote:

> On Tue, Apr 10, 2012 at 10:03 PM, Mikko Ohtamaa
> <mikko+plone-75aZqqp77KCaMPzRcYMCawC/[email protected]> wrote:
>>> short, ragged lines, and not reflowing paragraphs, for ease of editing &
>>> versioning.
>>
>> Personally I don't care
>
> Good :-)
>
> While going through the dexterity manual, I formatted the last part
> in that way. See the pull request:
>  https://github.com/giacomos/collective.dexteritymanual/pull/1
>
>> * Modern editors can wrap lines (take that, pico!)
>
> Yeah, but I think that wrapping paragraphs is often counterproductive for text
> source files.
>
>> * Also some people tend to justify text with somewhat sane line width
>> (60-160)
>
> When the text source is meant to be read by many (e.g. README files), that make
> sense. When it is mainly the source format for publication in other formats,
> then not so much.


These manuals will eventually distributed with the plone source and
read from source.


>
> --
> jean                                              . .. .... //\\\oo///\\
>
> ------------------------------------------------------------------------------
> Better than sec? Nothing is better than sec when it comes to
> monitoring Big Data applications. Try Boundary one-second
> resolution app monitoring today. Free.
> http://p.sf.net/sfu/Boundary-dev2dev
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs

------------------------------------------------------------------------------
Better than sec? Nothing is better than sec when it comes to
monitoring Big Data applications. Try Boundary one-second 
resolution app monitoring today. Free.
http://p.sf.net/sfu/Boundary-dev2dev