PROD-365 - doc coverage

boom
this looks like more than a docs change. why does it yield and return?