I also don't know anyone else who would assume that others don't know "how this has always worked" except someone who only learned themselves last week and think they know a lot now.
I didn't say anything about adding comments as an end user. My point about comments was that least suprise could be resolved trivially without even changing the existing desired behavior, by nothing more than the OS shipping a default sshd_config that was structured so that it clearly had a section that will be overridden, and a section that will override, which requires nothing more than a few comments.
I'm looking at a couple sshd_config files on my servers, and the Include directive for the overrides is the first non-comment line in the file.
Having that Include be first means that changing any settings in the sshd_config file will override anything set by sshd_config.d/* files.
What in the heck are these people doing to break their config? There really is no legitimate issue here.
"That's just not how it works" Incorrect.
"dogma "principle of least surprise"" That is not dogma, it is a principle. It's right there in the name.
Dogma might be the understanding that the principle of least suprise is a valid principle.
But this suggests you don't subscribe to this silly "dogma" eh?