[Doc-SIG] Python docs in reST?

Michael Hudson mwh at python.net
Thu May 19 10:20:36 CEST 2005

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...


  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

More information about the Doc-SIG mailing list