x/tools/go/pointer: explain deprecation

[dannyc-grafana]

What is the URL of the page with the issue?

golang.org/x/tools/go/pointer

What is your user agent?

Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:133.0) Gecko/20100101 Firefox/133.0

Screenshot

No response

What did you do?

I browsed to the page in quesiton

What did you see happen?

Docs are returned, including a version string that clearly indicates the package is deprecated. However, the body of the documentation contains no reference to the reason for deprecation or warning about the same.

What did you expect to see?

I think a warning at the top of the package docs stating that:

1. The package is deprecated and unmaintained.
2. There are known correctness bugs
3. More can be read at x/tools/go/pointer: isolate, tag, and delete the pointer analysis #59676

would be quite useful-- I eventually landed on the issue after digging around, but it took considerably more effort than I'd like to admit.