Fix link scope

[timhoffm]

Typically, one does not include articles in the link.

[drammock]

Is there guidance about this somewhere? I'm inclined to trust your intuition, but FWIW my instinct here is opposite: I tend to want make links on phrasal consituents (which in this case would mean the full noun phrase, including the article). But that might just be me / my training. Happy to follow suit if you say "at least matplotlib and scipy do it consistently this way" or some similar impression of loose consensus.

[github-actions]

Coverage report

This PR does not seem to contain any modification to coverable code.

[timhoffm]

My proposal was based in intuition. But thinking about it, I believe it's because "Sphix Themes Gallery" is a proper noun. Note that "Sphinx Book Theme" above also does not contain the article. I would leave out articles if the rest of the link is just the proper noun. By that the proper noun is more clearly visible.

Examples for proper-name only:

• the Sphinx Book Theme has a similar look and feel
• and Furo is another excellent choice.
• You can also see the Sphinx Themes Gallery for more ideas.

Whereas include the article if it is a phrase:

• and the Furo theme is another excellent choice.
• You can also see the Sphinx Themes gallery for more ideas. - Would be if the pages was only called "Sphinx Themes".

I believe the issue is specific to proper nouns that are phrase like, i.e. where it contains a noun itself. In that case language flow tends to add an article. Compare:

• See Furo for more ideas. [no article - OK]
• See Sphinx Theme Gallery for more ideas. [no article - slightly bumpy]
• See the Sphinx Theme Gallery for more ideas. [with article - better flow]

While the language flow profits from the article here, I still believe the link should only cover the proper noun to make it stand out more.

It's hard finding authoritative reference. Some loosely related links:

• https://www.nngroup.com/articles/writing-links/#:~:text=Use%20as%20many%20words%20as,goes%20to%20the%20same%20place.
• https://ux.stackexchange.com/questions/129285/should-a-grammatical-article-be-a-part-of-a-web-link-anchor
• https://www.stylemanual.gov.au/structuring-content/links#:~:text=Keep%20them%20concise%20and%20put,and%20assess%20the%20link's%20relevance.

[trallard]

I have no strong opinion here (regarding including articles or not) and I have to admit I have never given this a lot of thought.

So long we always use descriptive text (and not phrasing like: here, link, click here) this should be fine from an a11y and SEO point of view which I do have strong opinions on. So whatever y'all decide is good, but perhaps it's worth checking we use such an approach throughout the docs for consistency.

[timhoffm]

Just a case in point from the footer:

But overall, this was thought as a quick fix for something I stumbled over, and I've already lost far too many words on this 😄.
Please take or leave as you see fit.

[drammock]

I'm convinced