[Python-Dev] Questions/comments on documentation formatting

[Ben Finney]

"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