more documentation
+ code style fixes