edits to the docs based on the work currently done

Resolves #96 

![image](https://f.cloud.github.com/assets/359239/1103047/a7fa7e36-187e-11e3-9471-076513222ab5.png)

Anything that's:

 - grossly inaccurate?
 - in the wiki but should be here?
 - missing?