[Python-Dev] status of development documentation

["Martin v. Löwis"]

Phillip J. Eby wrote:
> 1. Fredrik doesn't want to have to install a LaTeX toolchain in order to 
> get an HTML version of the documentation
> 
> 2. Fredrik likes using whatever tools he has for editing HTML better than 
> whatever he has for editing LaTeX
> 
> 3. Fredrik believes that more people would participate in updating Python 
> documentation if it didn't require a LaTeX toolchain or LaTeX-friendly editor.
> 
> (Of course, these are equally arguments for using other formats besides 
> HTML, especially formats that are closer to plain text.)

Except, of course, for any other format (than HTML), you would have to
substitute "Fredrik" by somebody promoting that other format.

> By the way, I'm not sure I see what the problem with authoring Python 
> documentation with reST would be.

Really not? How do we get from where we are to where you would like
us to be? With this, I mean both technically (but perhaps I'm unaware
of some tool that does the conversion automatically and lossless)
and emotionally (but perhaps everybody but Fredrik and Barry could agree
to switch to reST).

Regards,
Martin