Skip to content

PEP 12: Add list of intersphinx mappings #4610

Description

@zklaus

PEP 12 is very helpful in writing PEPs and has a section on intersphinx. However, to know the available intersphinx mappings, one has to know where to look in the sphinx configuration.

I think it would be useful to include the list directly in PEP 12.

Alternatively, if that is considered to be at too high a risk for getting outdated, one could add an explanation on where to find it.

Activity

  1. akanil18 commented on Mar 13, 2026

    @akanil18

    Hi I would love to work on this issue.

    I agree that maintaining a hardcoded list of intersphinx mappings in PEP 12 might get outdated quickly. I can open a PR to add a short explanation in PEP 12 on where authors can find the available mappings within the Sphinx configuration.

    Could you please assign this issue to me?

  2. merwok commented on Mar 14, 2026

    @merwok
    Member

    Assignment is not used like that. You can make a PR and link it to this ticket. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions