Document yield
Explain `empty` more
Explain `reduce` more
Better document generators