provide better error messaging - fixes #286

Are there other errors we should catch / any better ideas for wording the error message?
I don't mind linking to it, but if there's a mutual concern, we can always just link to the docs site/gh readme.