much, much better prose in the documentation