documentation and small tweaks