fixing documentation and adding competency question acceptance test that raises error