I just wrote a little something here with suggestions on how to improve your Gem configuration in order to avoid misconfigurations, missing values, configuration scope issues, and more generally: disappointment.