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.
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.toml pins sqlalchemy[asyncio]>=2.0.48
uv.lock resolves to sqlalchemy 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
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
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 thoughairflow-corenow requires SQLAlchemy 2.x .I don't usually open issues for documentation, but this one is better handled by
someone with SQLAlchemy domain knowledge.
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 thoughairflow-corenow requires SQLAlchemy 2.x:airflow-core/pyproject.tomlpinssqlalchemy[asyncio]>=2.0.48uv.lockresolves tosqlalchemy 2.0.51The 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
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/sqlitecomments are a provider change, so no newsfragment thereeither).
Drafted-by: Claude Code (Opus 4.8); AI Summary section compiled at the maintainer's request