add a ProviderUnavailableException
Docs updates. Refs #8.
Merge branch 'BartSaelen-master'