I have a lot of love for Homebrew from many years of using it, but I don't think you'll ever find me using it in macOS or Linux again. I use Nix on both now and I'm convinced that it is the saner way of doing things.
Someone also did a video walkthrough of this material recently. I don't have the link, but it might be worth searching for.
The ticket was closed because the man-page has a technical description of what the command actually does, and people should just know how the command is supposed to work, even if the reference manual tells them otherwise.
Beginner-hostility appears to be baked into the ecosystem.