Better error messages

Move explanations to README (which in turn will generate a page on the site) and add a url in the error messages to the relevant docs.