Repository navigation
Update SQLAlchemy documentation links from 1.4 (en/14) to 2.0 (en/20) #69164
Description
Human Summary
While reviewing #69150 (which fixes #25461), I noticed that a number of our
SQLAlchemy documentation links still point at the SQLAlchemy 1.4 docs (en/14), even though
airflow-core now requires SQLAlchemy 2.x .
I don't usually open issues for documentation, but this one is better handled by
someone with SQLAlchemy domain knowledge.
Clarification: This is not intended to be a simple 1.4 -> 2.0 replacement - the entire documentation should also be reviewed to ensure it reflects any critical changes between the 1.4 and 2.0 versions
AI Summary
What
Several SQLAlchemy documentation links across the codebase still point at the
SQLAlchemy 1.4 docs (https://docs.sqlalchemy.org/en/14/...), even though
airflow-core now requires SQLAlchemy 2.x:
airflow-core/pyproject.tomlpinssqlalchemy[asyncio]>=2.0.48uv.lockresolves tosqlalchemy 2.0.51
The SQLAlchemy 1.4 constraint that originally drove some of these references is
gone, so the user- and developer-facing doc links should point at the en/20/
(2.0) docs that match the version Airflow actually runs.
Acceptance criteria
- All nine links above use
en/20and still resolve to a live page + anchor. -
set-up-database.rst:201is left untouched. -
breeze build-docspasses (no broken external-link / spellcheck failures).
Notes
Doc/comment-only — no behavior change, no newsfragment needed (the
providers/sqlite comments are a provider change, so no newsfragment there
either).
Drafted-by: Claude Code (Opus 4.8); AI Summary section compiled at the maintainer's request
Activity
Dev-iL commentedon Jun 30, 2026
This is false. A
en/20path exists below:kalyanram07 commentedon Jun 30, 2026
Hi @shahar1! I would love to fix these documentation links for my first contribution. Please assign this issue to me!
shahar1 commentedon Jun 30, 2026
Got sloppy here, removed it from the AI summary.
Hey! Feel free to raise a PR to fix it - currently we don't assign people to issues by policy.
AshleyAHuang commentedon Jul 1, 2026
There are now three open PRs addressing this issue:
.rstdoc file onlymanager.pyandbase.pyonlyprovider hook (
providers/sqlite/src/airflow/providers/sqlite/hooks/sqlite.py)that the other two miss
Flagging so a maintainer can pick whichever is preferred and close the
others per the "better PR wins" convention — happy to close mine in favor
of either of the other two if one is extended to cover the missing file.
Drafted-by: Claude Code (Sonnet 5); reviewed by @AshleyAHuang before posting
pallaviB463 commentedon Jul 4, 2026
Hi! I'd like to work on this issue. Could I be assigned?
shahar1 commentedon Jul 4, 2026
Hey! Feel free to raise a PR to fix it - currently we don't assign people to GitHub issues by policy.
Fix remaining SQLAlchemy 1.4 doc link → 2.0 in config.yml
Fix remaining SQLAlchemy 2.0 documentation links in core
vishal-1401 commentedon Jul 25, 2026
Hi, I'd like to work on this issue. Could you please assign it to me?
shahar1 commentedon Jul 25, 2026
Feel free to raise a PR, ,there are no official assignments by policy
vatsrahul1001 commentedon Jul 28, 2026
Both #69168 and #69168 need work to be done. Moving this to 3.3.2
LeonxLJX commentedon Aug 31, 2026
Hi! I'd like to update the SQLAlchemy documentation links from 1.4 to 2.0. Thanks!
LeonxLJX commentedon Sep 1, 2026
Hi! I'd like to work on this. I'll trace the failing path in Airflow, write a regression test, implement the fix and ensure the related unit tests pass. Please let me know if I can proceed / be assigned.
sreecharan-desu commentedon Sep 2, 2026
Data point from a fresh
maincheckout: grep fordocs.sqlalchemy.org/en/14is clean now. Might be worth double-checking whether #69168 / open drafts still diff anything before more link-update PRs pile up.