use page titles as link text to avoid warnings

[nedbat]

Previously we had scary red messages:

devguide/core-developers/memorialization.rst:5: WARNING: Duplicate explicit target name: "here". [docutils]
devguide/core-developers/memorialization.rst:5: WARNING: Duplicate explicit target name: "here". [docutils]

---

📚 Documentation preview 📚: https://cpython-devguide--1532.org.readthedocs.build/

[nedbat]

Though TBH, that warning seems kind of dumb to me... Maybe we can disable it? /cc @hugovk

[hugovk]

A double trailing underscore make the link an "anonymous" one and avoids warnings:

• https://stackoverflow.com/a/74258281/724176

-`here <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_.
+`here <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`__.

[nedbat]

sigh there's always some other twist to learn about .rst.... I've used double-underscore in its other form:

Look over `there`__.

__ https://overthere.com

[ezio-melotti]

In general the text of the link shouldn't be a generic text like "here" or "link", but should reflect the content of the page it links to, so rephrasing those links would be preferred.

If possible, the link should be the actual title of the page and/or the name of the service (e.g. "See also the Discourse best practices for deceased community members"). Doing this will also avoid warnings.

[hugovk]

Good point: https://usability.yale.edu/web-accessibility/articles/links#link-text

[hugovk]

Suggested change

	`GitHub Deceased User Policy <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_
	`Deceased User Policy <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_

[ezio-melotti]

Based on what we discussed, it would be better to include "GitHub" in the link, but the current sentence repeats it twice. I would either remove the other one:

Suggested change

	The general policy regarding deceased users on GitHub is described on their
	`GitHub Deceased User Policy <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_
	The general policy regarding deceased users is described on their
	`GitHub Deceased User Policy <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_ page.

or simply:

Suggested change

	The general policy regarding deceased users on GitHub is described on their
	`GitHub Deceased User Policy <https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_
	See also the `GitHub Deceased User Policy
	<https://docs.github.com/en/site-policy/other-site-policies/github-deceased-user-policy>`_ page.

[nedbat]

I've tweaked the GitHub link title to remove the duplication.