Updated README file documentation

Updated the doc for our purposes.  I tried to make it a bit more generic and independent of our use case.  If it's useful, please merge it in.