I'm still refining the feature given some late feedback and that it will be public API. I guess with the help of Aaron we will get some nice documentation in, as it's not showing up in the master python API docs. I thought it would be taken automatically from the Python doc.
Is this a correct source for the documentation format that we are using? I know we use sphynx but doesn't look like RST to me: http://www.sphinx-doc.org/en/master/usage/quickstart.html Pedro.