update docs about new generator function structure
update docs about new generator function structure

rename the generator functions in the docs, so that they are automatically documented. Improve the text around the automatic documentation to describe how to use them.

edoddridge/MIM,edoddridge/aronnax