some small fixes and more documentation