improve documentation a bit