docs on MeanComparer
docs on acceptable improvement factor
merge PR