[Doc-SIG] Proposal for indented sections in reStructuredText

Guido van Rossum guido@digicool.com
Wed, 13 Jun 2001 09:16:46 -0400

I haven't been able to follow this, but I read David Goodger's clear
post on this topic.

I still think that using indentation to indicate sectioning is wrong.
If you look at how real books and other print publications are laid
out, you'll notice that indentation is used frequently, but mostly at
the intra-section level.  Indentation can be used to offset lists,
tables, quotations, examples, and the like.  (The argument that
docstrings are different because they are input for a text formatter
is wrong: the whole point is that they are also readable without

I reject the argument that using indentation is Pythonic: text is not
code, and different traditions and conventions hold.  People have been
presenting text for readability for over 30 centuries.  Let's not
innovate needlessly.

I think allowing indented sections because it's popular is unpythonic:
there should be only one way to do it.  Existing ST should be run
through a converter.

--Guido van Rossum (home page: http://www.python.org/~guido/)