config: (docs) clarify return type

(Formerly titled "documentation fixes", now reduced to just the one commit that has been receiving a lot of attention, with the others that were bundled moved out to their own MRs).