documentation and tweaks