Added An Upgrade Guide And Better Usage Docs

In response to #67 and #186.