more documentation and stylefix