I think that the logic of the actual counting algorithm should have a paragraph or two at the top of the README file