[spondylosaurus]

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

[ianhawes]

This is ironic because supposedly Google also penalizes links which are "keyword stuffed".

[spondylosaurus]

Ha, I've never thought about that! Although when I'm writing tech docs stuff like SEO isn't usually top of mind :P