[Python-Dev] The docs, reloaded (original) (raw)

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

Hoi,

Stephen J. Turnbull <stephen 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.

Regards, Armin

More information about the Python-Dev mailing list