enhanced XSR documentation for generators