clarify the documentation a bit