Add docs to help users upgrade from < 1.0, fixes #877

* Help with new command line usage
* Help with deprecated flags
* Help with baseurl
* Help with drafts