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

Link to official numpy documentation is hard to spot #400

Closed
eric-wieser opened this issue Feb 15, 2021 · 4 comments · Fixed by #402
Closed

Link to official numpy documentation is hard to spot #400

eric-wieser opened this issue Feb 15, 2021 · 4 comments · Fixed by #402

Comments

@eric-wieser
Copy link
Member

I completely missed that the word "here" was a link on this page, possibly due to a blue-light filter.
The fact that it appears in bold right at the top of the page furthers the confusion, suggesting that that page itself is the official documentation!

Note that the image below is much clearer on my screen than the actual page is, as chrome uses a different color profile for PNG images than it does for text colors!

image

@InessaPawson
Copy link
Member

@eric-wieser One possible solution could be replacing the word here with the address of the NumPy docs: https://numpy.org/doc/stable.

Wrt difference in color profiles, we are aware of the issue (#399, #398, #397).

@eric-wieser
Copy link
Member Author

The color profile issue is really just me complaining about github, but I'm glad its also on your radar for the website!

Changing the link text to a url would help. Maybe a "visit the official documentation" button would work too. I don't feel strongly, just thought I should record my confusion somewhere.

Looking at this again in the morning, the problem is definitely largely brought on my an extreme blue-light filter I had enabled in the evening.

@melissawm
Copy link
Member

melissawm commented Feb 16, 2021

In any case, for accessibility, it would be nicer to rephrase that to something like:

You can find the official NumPy documentation by [clicking here](link).

or

You can find the official NumPy documentation by [visiting this page](link).

@InessaPawson
Copy link
Member

How about the following phrasing:

For the official NumPy documentation visit numpy.org/doc/stable.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants