Documentation in the module itself

A ticket to collect requests for documentation / note problems that people find. Specifically, using the help(object) system in python should give more meaningful information.