review and fix docs