improved documentation
more fixes