While I agree that Mercurial has done a better job with the cli and docs for making things simple, you've linked to the reference of git-reset instead of the eq

While I agree that Mercurial has done a better job with the cli and docs for making things simple, you've linked to the reference of git-reset instead of the equivalent doc for undoing things [1] which is much simpler and covers similar cases. One thing I note is that in the doc you linked switches that are default behaviour are typed out. If I look at my shell history the git commands I'm actually typing look closer to the Mercurial doc than the git doc. [1]: https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things