adds more information to the documentation of generators
Merge pull request #1590 from fxn/master

adds more information to the documentation of generators