more work on generator docs