Also flesh out the documentation a bit

Signed-off-by: Kent Overstreet <kmo@daterainc.com>