Skip to content

RST markup: recommend anonymous hyperlinks#1709

Merged
hugovk merged 3 commits into
python:mainfrom
hugovk:anon-links
Nov 29, 2025
Merged

RST markup: recommend anonymous hyperlinks#1709
hugovk merged 3 commits into
python:mainfrom
hugovk:anon-links

Conversation

@hugovk

@hugovk hugovk commented Nov 29, 2025

Copy link
Copy Markdown
Member

To avoid potential clashes in target names, let's recommend "anonymous hyperlinks", which use a double trailing underscore instead of a single underscore.

Re: python/cpython#142057 (comment)


Not in this PR, updating all the other hyperlinks in the devguide would look like this: hugovk@072c3da

Worth including or not?


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

@picnixz

picnixz commented Nov 29, 2025

Copy link
Copy Markdown
Member

If you use anonymous links in markup.rst, let's include the others as well I guess. I think it would make more sense to have one of the following:

  • 1 PR for recommendation, 1 PR for refactoring.
  • 1 PR for both of them

But putting some refactoring in the recommendation feels weird..

@hugovk

hugovk commented Nov 29, 2025

Copy link
Copy Markdown
Member Author

@picnixz Which option do you want?

@picnixz

picnixz commented Nov 29, 2025

Copy link
Copy Markdown
Member

Really, it's up to you. I think it's fine to include your other commit :') less noise, less approval needs

@picnixz

picnixz commented Nov 29, 2025

Copy link
Copy Markdown
Member

(I've reviewed all files, well not in details, but AFAICT, everything is fine, thank you!)

@hugovk hugovk merged commit 7a84382 into python:main Nov 29, 2025
5 checks passed
@hugovk hugovk deleted the anon-links branch November 29, 2025 16:30
@python python locked as resolved and limited conversation to collaborators Mar 26, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants