This should be a docstring instead of a comment form.  This module may not necessarily end up itself part of the public API, but I think we probably should to be safe and guide anyone in ipython who looks at the module (because it will be present there even if it isn't officially in the API).

Also, minor comment: to be consistent with other docs this should be "in this module", not "in this file" if its a docstring.