readme: add docs

Continued from #2

cc @rlidwka
This could use a good note somewhere that `next()` should never be called if you've ended (or really just started writing) the response.