fixing up some documentation and some rearranging
added README, and some instances
README and some new instances.