filling out the readme
a first cut of the readme