final final tweaks and documentation updates