final tweaks plus documentation