first commit of documentation (I also changed README.md since that stuff was folded into the main docs, and moved the specs up under the main docs)