first draft of doc makeover
readme draft v2
moved usage to the top of readme
merge docs branch