improve documentation some more