documentation + fix for research + pass