Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Closed
dsnet opened this issue May 17, 2018 · 5 comments
Closed

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

dsnet opened this issue May 17, 2018 · 5 comments
Labels
pkgsite Proposal Proposal-Accepted Tools This label describes issues relating to any tools in the x/tools repository.
Milestone

Comments

@dsnet
Copy link
Member

dsnet commented May 17, 2018

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
Copy link

kegsay commented Nov 22, 2018

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

@dmitshur
Copy link
Contributor

@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
Copy link
Member Author

dsnet commented Feb 20, 2021

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
Copy link
Member Author

dsnet commented Apr 13, 2021

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
Copy link
Member

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pkgsite Proposal Proposal-Accepted Tools This label describes issues relating to any tools in the x/tools repository.
Projects
None yet
Development

No branches or pull requests

6 participants