documentation for generators