[Python-Dev] Questions/comments on documentation formatting (original) (raw)
Ben Finney ben+python at benfinney.id.au
Tue Jan 20 04:49:54 CET 2009
- Previous message: [Python-Dev] Questions/comments on documentation formatting
- Next message: [Python-Dev] Questions/comments on documentation formatting
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
"Benjamin Peterson" <benjamin at python.org> writes:
On Mon, Jan 19, 2009 at 9:23 PM, Raymond Hettinger <python at rcn.com> wrote: > From: "Brett Cannon" <brett at python.org> >> >> 1. Why is three space indents the preferred indentation level? > > I've also wondered about this. It is somewhat incovenient > when bringing in code samples from files with four space indents.
It's just reST indentation that is 3 spaces.
It doesn't have to be. When writing reST, I always make directives so they will line up nicely at 4-space indents:
===== Normal paragraph
.. Comment
.. foo::
bar=====
-- \ “I was the kid next door's imaginary friend.” —Emo Philips | `\ | o_) | Ben Finney
- Previous message: [Python-Dev] Questions/comments on documentation formatting
- Next message: [Python-Dev] Questions/comments on documentation formatting
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]