provide better error messaging - fixes #286

Are there other errors we should catch / any better ideas for wording the error message?
I thought of that too but I didn't want troubleshooting links in the error messages themselves in case links become dead or unreachable for some reason. :thought_balloon: