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

Replace “here” links with something more informative #100

Open
anthonyfok opened this issue Dec 16, 2022 · 0 comments
Open

Replace “here” links with something more informative #100

anthonyfok opened this issue Dec 16, 2022 · 0 comments
Assignees
Labels
Documentation Improvements or additions to documentation Task

Comments

@anthonyfok
Copy link
Member

The current RiskProfiler website (v1.0, v1.0.1) contains various "here" links. Take, for example,, the following passage on the “Download Data” page:

Probabilistic earthquake risk data is available through the Open Disaster Risk Reduction (OpenDRR) website here. More information about probabilistic earthquake risk concepts can be found here and more information about how the data was generated can be found here.

The use of such “here” is not considered best practice, and confuses me personally. The Smashing Magazine has this to say:

“Here” Conceals What Users Are Clicking

Some links use the word “here” instead of “click.” The problem with using “here” in a link is that it conceals what the user is clicking. The text around the link might explain what they’re clicking, but when the user reads the link itself they won’t have a clue. This means that the user has to read the text all around the link to understand the context of the link, thus impeding them from taking the quick and short route of clicking the link directly. If there’s a lot of text, this could slow the user down a lot.

See Why Your Links Should Never Say “Click Here” — Smashing Magazine for the full article.

Let's rewrite these sentences to have more informative link descriptions!

@anthonyfok anthonyfok added Documentation Improvements or additions to documentation Task labels Dec 16, 2022
@anthonyfok anthonyfok self-assigned this Dec 16, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Improvements or additions to documentation Task
Projects
None yet
Development

No branches or pull requests

1 participant