[MERGE][0.17] ReST section dividers

[Ian Clatworthy]

Alexander Belchenko wrote:

>> In general probably the editors people use on Linux are more likely to
>> handle crlf, or at least display it reasonably.  gedit, which is about
>> the closest approximation to notepad, can display a crlf file but
>> mixes up the endings if you edit and save it.
> 
>> So how about if we make the documentation files always crlf format?
> 
> Please, *don't*.
> Currently our bundle format is vulnerable to CRLF.
> 
> All my point is not about LF vs CRLF, but about .txt extension.
> I tried to rename files that included into *another* big ReST document,
> to properly handle dependencies. That was my point. I ever don't touch
> other standalone documents. But I'm give up.
> 
> I'll rework my patch based on the discussion:
> 
> * use always .txt extensions
> * use bike-shed color scheme that most intuitive for most of us
> 
> [µ]

Alex,

Thanks for your work on this. I value it highly.

As you know, it's scary how many people will make a "30 second
assessment" about a project based on the quality of it's web site and
the organisation of its documentation. We're better than many (with room
to improve) on the web-site front. The documentation organisation is
below when I'd like to see us though.

If it helps, I always remapped the default 'txt' file editor on Windows
to be WordPad instead of Notepad. The only reason was it's handling of
Unix text files. The problem isn't savvy users though - it's Windows
developers expecting things to "just work" like pure Windows apps. We
need to accomodate them.

If we use .rst, is there a rst2txt converter than produces real text?

Ian C.