minor fixes and documentation
more documentation