issues/#509-incorrect-doco-on-config-precedence

Related to #509, @johnsimons can you review?