further work on evaluator documentation
pulled remote