Add documentation for similarity score

[mbifeld]

People get confused by what the similarity score is and how they should determine it for their expected outputs. We should also detail when a doc would stop running if the expected output doesn't meet the minimum similarity score and when it would continue, if at all.