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

:warning: Not ready to merge :warning:
 
* Help with new command line usage
* Help with deprecated flags
* Help with baseurl
* Help with drafts