- add some more docs to yield_per