Configuration help should be better documented and tested

[timspainNERSC]

Following the comment of @a-smith-github on PR #308, the help configuration system needs to be better documented and also tested.

[einola]

Closed by merging #350