Improve generator documentation

[Closes #749]
[Fixes #722]
Merge branch 'generator-docs'