fix docs; and final tweaks