Skip to content

docs: Repair unresolved documentation links - #1481

Open
Parsnip37 wants to merge 1 commit into
python-babel:masterfrom
Parsnip37:codex/repair-documentation-links
Open

Parsnip37 wants to merge 1 commit into
python-babel:masterfrom
Parsnip37:codex/repair-documentation-links

Conversation

@Parsnip37

Copy link
Copy Markdown

The HTML documentation contains four unresolved references: zoneinfo, two CLDR links, and entry point. They are left unlinked and cause a Sphinx build with warnings treated as errors to fail.

Repair the CLDR hyperlink syntax, use the existing Python intersphinx mapping for zoneinfo, and link entry point to the Python Packaging User Guide specification.

Validation with the repository's Sphinx 9.1 dependency and CLDR 49 data:

  • Unchanged base: the complete HTML render reports the four unknown-target errors.
  • This patch: the same render passes with -W --keep-going -E -a.
  • Inspected the four destination links in the rendered HTML and opened the official destination pages.

No software test suites, doctests, or example programs were run. Only documentation markup changes.

AI disclosure: OpenAI Codex researched and prepared this patch, documentation rendering, commit message, and PR description.

Repair the malformed CLDR links and resolve the missing zoneinfo and
entry-point references. The strict HTML documentation render now
completes without errors.

Generated-by: OpenAI Codex

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant