[Proposal] Rule to discourage generic link text

[khiga8]

Hello! First off, thank you for this project!

I wanted to suggest an accessibility-focused rule that discourages generic link text from being set such as Read more, Learn more, link, Click here, here, etc.

Screen reader users often navigate through a page by tabbing through links, or by using a screen reader menu that displays all the links on a page. If the link text is super generic like, Learn more, it's not clear where that link will go to without needing to navigate the entire surrounding context. Descriptive link texts are beneficial even for non-screen reader users.

Access Guide: Descriptive link text

I'm thinking that we could have a default array of discouraged link text, and allow additional ones to be configured.

I'm happy to take this work on. Let me know what you think!

[DavidAnson]

This makes sense and should be pretty straightforward since it can use the parser output for links directly. There is precedent in existing rules for analyzing link content that could inform the implementation of this rule. There is already an "accessibility" tag that can be used here. I plan to do a new release soon and will not include this due to timing, but you could iterate in a PR if you'd like. Please see CONTRIBUTING.md or similar PRs for expectations. Thanks!

[khiga8]

2 years late, but I'll pick this up :)

[DavidAnson]

Haha, these days I recommend the micromark parser. The custom rule docs are up to date!

[DavidAnson]

(I guess you are proposing to add this to the framework, so you'll HAVE to use that parser. :) Please review the contributing guidelines and share early/often so we can avoid misunderstandings.)

[khiga8]

Sounds good!

I just opened [WIP] Add new rule: no-generic-link-name #1459, if you'd like to provide a first pass review to ensure I'm on the right track! :)