[Python-Dev] The docs, reloaded

Armin Ronacher armin.ronacher at active-4.com
Tue May 22 13:41:19 CEST 2007


Stephen J. Turnbull <stephen <at> xemacs.org> writes:

> IMO that pair of examples shows clearly that, in this application,
> reST is not an improvement over LaTeX in terms of readability/
> writability of source.  It's probably not worse, although I can't help
> muttering "EIBTI".  In particular I find the "``'...'``" construct
> horribly unreadable because it makes it hard to find the Python syntax
> in all the reST.

Well. That was a bad example. But if you look at the converted sources and open
the source file you can see that rst is a lot cleaner that latex for this type
of documentation.


More information about the Python-Dev mailing list