[Doc-SIG] Python docs in reST?
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
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