Reading in general to more specific configuration directories in order and using the last value read makes the most sense to me. This is usually how I write my own applications.

Anyway, I thoroughly document the order and precedence, but the suggestion from Chris' blog to report more detail about the process is a good one.