update documentation
fix comments