Skip to content

Fix SMTP email backend documentation link - #75243

Merged
hussein-awala merged 2 commits into
apache:mainfrom
hussein-awala:codex/fix-smtp-email-backend-docs
Oct 20, 2026
Merged

hussein-awala merged 2 commits into
apache:mainfrom
hussein-awala:codex/fix-smtp-email-backend-docs

Conversation

@hussein-awala

@hussein-awala hussein-awala commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

The provider summary build fails with unknown document: 'apache-airflow-providers-smtp:email-backend' after SMTP registers its email backend. Move the existing page to the canonical email-backend.rst path expected by the shared directive and update its navigation link. The page content is unchanged. Add the old-to-new mapping in redirects.txt so old URLs redirect to the canonical page and publishing can add back-references for version switching.

This resolves the documentation failure blocking the provider wave in #75209, introduced by #74623.

Validation: fast and manual static checks passed. Strict Sphinx HTML builds of common.compat, SMTP and the provider summary passed with warnings treated as errors (-W --keep-going). The summary loaded SMTP's freshly built local inventory, which contains the canonical email-backend document. Also verified the generated utils/emailer.html redirect resolves to ../email-backend.html, and the publishing helper creates the reverse redirect in an older-version documentation fixture without overwriting its existing page. Pagefind search indexing was disabled only for the local build because it stalls under x86 emulation.


Was generative AI tooling used to co-author this PR?
  • Yes — OpenAI Codex (GPT-6)

Generated-by: OpenAI Codex (GPT-6) following the guidelines


Drafted-by: OpenAI Codex (GPT-6) (no human review before posting)

@aaron-y-chen aaron-y-chen left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@hussein-awala hussein-awala mentioned this pull request Oct 20, 2026
6 of 7 tasks
Comment thread providers/smtp/docs/email-backend.rst Resolved
The provider summary cannot build while SMTP's registered email backend
has no page at the shared directive's expected document name.
@hussein-awala
hussein-awala force-pushed the codex/fix-smtp-email-backend-docs branch from 7037619 to a261da3 Compare October 20, 2026 20:12
@hussein-awala
hussein-awala merged commit 89ce7a4 into apache:main Oct 20, 2026
58 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants