improve config

The goal of this pull request if to improve the documentation of our many installation settings.

While the later commits are harmless the first one might contain some bugs. So I am in favor of stalling this PR until after the next release.