Ask HN: When and why did Git config change from –list to list?

Just curious, as like most people I'm far too busy to study the release notes of every version update of every tool I regularly use. However it seems like quite a significant UX (or DX?) change to deprecate "git config --list" in favour of "git config list". I'm sure there are reasons for this, the subcommand approach is probably easier for newbies to learn than the flag-style UX, and it certainly makes the docs easier to read if you've never used git before and are learning it for the first time.

However I just stumbled across this change by chance when searching for the syntax and found that the docs page [0] does absolutely nothing to highlight the fact that this has changed and so seems to contradict every other blog post and article in the entire WWW that tells you to use --list.

For a few minutes I thought I was going insane. Eventually, scrolling down a lot, I found the words "DEPRECATED MODES: The following modes have been deprecated in favor of subcommands. It is recommended to migrate to the new syntax."

Seriously, who thinks like this? Who has such contempt for their users that they would change the UX of a decades-old tool used by millions and not bother to put a warning at the top of the current doc page along the lines of "hey guys, we just made a major change here, so don't worry if all the other websites out there seem to contradict this, click here to read more about the change and the reasons behind it..." ?

[0] https://git-scm.com/docs/git-config