I do understand that. I myself tend to skim caveats as it is. But at least caveats show up with `brew info`.
I'm still strongly in favor of adding this, but if you think it's not a good Idea then we can this.
This isn't the only Formula in brew that has caveats about the PATH.