Clarified role of contests file.

I was a bit confused when first reading this, but the "data flow"
section below made it more clear. Hopefully this is a minor improvement.
Merge pull request #3 from philipn/doc_improvement

Clarified role of contests file.