Looking for information on, how to document instance variables, I found this tracker entry and the following two PEPs:

- http://www.python.org/dev/peps/pep-0257/
- http://www.python.org/dev/peps/pep-0258/#attribute-docstrings

Maybe they are helpful.