[Doc-SIG] Python docs in reST?

[Michael Hudson]

Simon Burton <simon at arrowtheory.com> writes:

> Where I work now, they recently moved to python from a proprietary
> system. Mostly I think everyone is enjoying the change, but my boss
> is shocked at the lack of a "standard" python documentation system,
> and that the python docs are maintained separately, by hand.

Well, that's because the standard Python documentation is "type 2"
documentation (i.e. user docs) and any attempt to autogenerate those
is doomed...

Cheers,
mwh

-- 
  This makes it possible to pass complex object hierarchies to
  a C coder who thinks computer science has made no worthwhile
  advancements since the invention of the pointer.
                                       -- Gordon McMillan, 30 Jul 1998