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.