need README.md

[khale]

We need actual text in the readme to describe the layout of the source files and how to run the experiments. Should be clear enough such that someone with no knowledge of the code can go in and validate the experiments.