added more comments to the generator entities