I started with the "How-To Guide for Descriptors" by Raymond Hettinger http://users.rcn.com/python/download/Descriptor.htm It is one of several docs on the "New-style Classes" page at python.org http://www.python.org/doc/newstyle/