Real docs

I revamped the documentation, and added a sphinx conf.py file.

to build the docs with sphinx, see the README under /docs

once this is merged, we can publish the docs at RTD.

/cc @benpatterson @clytwynec @jzoldak 
just updated.