The install section is out of date, at least for macos homebrew. The emacs-plus package on homebrew (https://github.com/d12frosted/homebrew-emacs-plus) is the best for macos.
So rather than the install section being "out of date", I would say it is more conservative and may reduce the probability of users' first Emacs experience being buggy.
Also it appears --cocoa is no longer a valid option even on the default HB emacs, so it is out of date anyway.
https://github.com/d12frosted/homebrew-emacs-plus/blob/maste...
Lately been using it with native comp. Also solid.
Written about it a few times:
https://xenodium.com/emacs-plus-with-native-comp