simplify the documentation a bit