Document design flaw
Fix dir name in example
Include reasons in config error exception
Provide sample application