High level docs

Adding the examples, which I think are fairly well documented at this point -

Still need to do
* scenario config section
* model choices section
* developer model intro
* mapping utils intro and doc strings
* review urbansim readme
* review sanfran_urbansim readme

but it's definitely getting closer