:clipboard: Guidelines & Workflow for people contributing to our project(s) on GitHub. Please :star: to confirm you've read & understood! :white_check_mark:
"this" is a really unhelpful link text. 😕
It's bad for accessibility and SEO. 👎
Similarly [here]() or [link]() are exceptionally poor link text. 🙅
They tell me (and vision impaired people and Google Bot!) nothing about the hyperlink. 🤷♂️
Remember your objective to communicate with the person reading your documentation. 💬
Not force them to click/follow the link just to know what it is ... ⏳ 🤦♂️
Note: I only do one word links for effect ... never for actual work where we want to effectively communicate with people including those who are using a screen reader or the almighty Google Bot 🤖 praise be the algorithm. 🙌
Todo
[ ] Add section to README.md including this advice so we can avoid having PRs with [here]() style links. 🙏
"this" is a really unhelpful link text. 😕 It's bad for accessibility and SEO. 👎 Similarly [here]() or [link]() are exceptionally poor link text. 🙅 They tell me (and vision impaired people and Google Bot!) nothing about the hyperlink. 🤷♂️
https://www.mtu.edu/accessibility/training/web/link-text/![image](https://user-images.githubusercontent.com/194400/196665540-22ae7f9f-4718-4d40-bb78-aa80c8b1f8cd.png)
Remember your objective to communicate with the person reading your documentation. 💬 Not force them to click/follow the link just to know what it is ... ⏳ 🤦♂️
With that in mind I usually just use the actual URL as the link text e.g: github.com/dwyl/start-here
Or for brevity but not much loss of meaning: dwyl/start-here
Never here. Ever ...!
Todo
README.md
including this advice so we can avoid having PRs with [here]() style links. 🙏