first cut at the readme
added a bunch of doc to files interfaces