Skip to content

Infra: Document where to find available intersphinx mappings#5060

Open
BHUVANSH855 wants to merge 1 commit into
python:mainfrom
BHUVANSH855:fix-4610-intersphinx-mappings
Open

Infra: Document where to find available intersphinx mappings#5060
BHUVANSH855 wants to merge 1 commit into
python:mainfrom
BHUVANSH855:fix-4610-intersphinx-mappings

Conversation

@BHUVANSH855

Copy link
Copy Markdown

Summary

PEP 12 explains how to use Intersphinx references, but it does not indicate where authors can find the available intersphinx mappings.

This change adds a short note directing readers to peps/conf.py, which contains the current list of supported intersphinx mappings. This avoids duplicating the mappings in PEP 12 while making them easier to discover.

Closes gh-4610.

Changes

  • Add a note in the Intersphinx section of PEP 12 pointing readers to peps/conf.py.
  • Fix a missing comma in the list of example documentation sites.

Testing

  • Built the documentation locally using:
python build.py

The build completed successfully with no new warnings or errors.

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #33766972 | 📁 Comparing 5c7fae0 against latest (9bb3132)

  🔍 Preview build  

2 files changed
± pep-0012/index.html
± pep-0764/index.html

@hugovk hugovk changed the title gh-4610: Document where to find available intersphinx mappings Infra: Document where to find available intersphinx mappings Jul 27, 2026
@hugovk hugovk added the infra Core infrastructure for building and rendering PEPs label Jul 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

infra Core infrastructure for building and rendering PEPs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PEP 12: Add list of intersphinx mappings

2 participants