code cleanup and better explaination and evaluation results in docs