Doc better, testing better...a feedback loop, I was embarrassed by the
test when I wanted to write about it and so had to improve it.
Added a first pass at rating the different distance methods at the two
scales.