discoverability is a big problem, especially for CLI tools which can't afford to show small hints or "what's new" popups. I myself learned it from someone else, not docs.

I plan to pay it forward today with a post on my work slack. I just need to try it a time or two myself first.

Except they do. You can type <tab>, search the man page or read the release notes. They just don't force the user to.