improve documentation, fix errors in documentation