Comment on Don't use "click here" for link textComments−spondylosaurus1yGoogle developer style agrees, and encourages the following alternatives instead:- Make the link text match the exact text of the title or heading that you're referencing.EX: For more information, see [Load balancing and scaling].- Write a description of the destination page to use as the link text, capitalized as if it's part of the sentence.EX: You can use Cloud Scheduler and Cloud Functions to manage [task scheduling on Compute Engine].https://developers.google.com/style/link-text−ianhawes1yThis is ironic because supposedly Google also penalizes links which are "keyword stuffed".−spondylosaurus1yHa, I've never thought about that! Although when I'm writing tech docs stuff like SEO isn't usually top of mind :P
Comments
Google developer style agrees, and encourages the following alternatives instead:
- Make the link text match the exact text of the title or heading that you're referencing.
EX: For more information, see [Load balancing and scaling].
- Write a description of the destination page to use as the link text, capitalized as if it's part of the sentence.
EX: You can use Cloud Scheduler and Cloud Functions to manage [task scheduling on Compute Engine].
https://developers.google.com/style/link-text
This is ironic because supposedly Google also penalizes links which are "keyword stuffed".
Ha, I've never thought about that! Although when I'm writing tech docs stuff like SEO isn't usually top of mind :P