x/tools/cmd/godoc: add support for hotlinks

[dsnet]

Per #18342 (comment), the addition of hotlinks was accepted to be added to godoc. Filing this as a separate issue since the previous issue is conflating sections and hotlinks.

The design for it is in my comment here: #18342 (comment)

[kegsay]

Is there any update on this? I seem to recall you did this already and even had it hosted somewhere.

[dmitshur]

@dsnet has created a prototype for this, and this proposal is accepted, so it will be integrated into x/tools/cmd/godoc code. It hasn't happened yet, but updates will be posted here when there's progress.

[dsnet]

I re-filed sections as a proposal again (see #44447). I recently revisited some of my prototype work with hotlinking (#25444) and I'm increasingly convinced that it's troublesome since it can't completely eliminate the presence of false-positives, which is harmful because it actively links users to the wrong information. Furthermore, it goes against the Go philosophy that "clear is better than clever". See the end of the proposal in #44447 for detailed arguments against hotlinking.

[dsnet]

I've been dubious about the hot-linking feature as it currently stands due to it propensity for false positives. I filed #45533 to amend this accepted feature to use an explicit syntax for links.

[seankhliao]

I think we can close this with the addition of links in comments.