Uche Ogbuji of FourThought has
posted a DTD
proposal for Python class documentation.
Although DocBook
is an
established and widely used solution to the
documentation problem, it is
complex and takes time to learn.
It will be interesting to see whether this
simpler proposal proves
sufficient for class documentation.