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/pkgsite: deprecated functions do not present a ¶ link at the doc site #60476

Open
kortschak opened this issue May 28, 2023 · 0 comments
Open

Comments

@kortschak
Copy link
Contributor

What is the URL of the page with the issue?

https://pkg.go.dev/runtime but any page with a deprecated label will do.

What is your user agent?

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

Screenshot

A screenshot will not capture the issue because the ¶ requires a mouse over to appear (this in itself hampers discovererability, but I'm resigned to websites being glossy and non-accessible nowadays).

What did you do?

Navigate to a page with a deprecated function and scroll to the docs for the function. In the example, CPUProfile

Attempt to get a link to a deprecated function to use in an email. This was in the context of wanting to discuss the deprecation.

Note that the link is available in the ToC, but this requires losing context to get the link.

What did you expect to see?

A ¶ link to the function's doc entry as exists for non-deprecated functions.

What did you see instead?

No link mark, only an option to hide the doc.

@gopherbot gopherbot added this to the Unreleased milestone May 28, 2023
@kortschak kortschak changed the title x/pkgsite: deprecated functions do not present a ¶ link at the doc sight x/pkgsite: deprecated functions do not present a ¶ link at the doc site May 28, 2023
@jamalc jamalc modified the milestones: Unreleased, pkgsite/later Jun 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants