more documentation and minor fix