Just a suggestion, but maybe put a link to [the notebook @tbekolay pointed to before](http://nbviewer.ipython.org/urls/gist.github.com/ChrisBeaumont/5758381/raw/descriptor_writeup.ipynb). Before reading that, I had no idea how descriptors worked, and now they make sense. Or the link could be in a code comment, instead.