potiuk opened a new pull request, #76792:
URL: https://github.com/apache/airflow/pull/76792
The Docker image documentation was one long "Building the image" page that
mixed the
standard ways of building an image with rarely needed expert cases. The
production-friendly
path - start from the slim image, and switch to customizing only when your
dependencies need
compiling - was hard to find. This splits the docs into focused pages so
that simple things
are simple and complex ones are possible.
* **Quick start** - a three-step decision guide: extend the slim image,
extend the regular
image, or build the image with the extras and packages you need. It shows
typical
compilation errors that tell you to move to the third step, and why that
gives a much
smaller image.
* **Extending**, **Customizing** and **Advanced cases** are separate pages;
Advanced cases
opens with a "What do you want to do?" guide and now includes the former
Recipes page and
a new "Dependency caching" chapter explaining when the cache helps.
* **Legacy images** - states that the deprecated `-legacy` images are not
published, and how
to build one.
* The overview is shorter; image variants, the runtime environment (former
Entrypoint),
"Working with the image" (quick test options) and the security FAQ (split
into three
pages) have their own pages, grouped in the left menu.
* The default Python version (3.13) and the number of providers are now
consistent across
the pages and `README.md`; the documented `DEPENDENCY_CACHE_EPOCH` default
now matches the
`Dockerfile`.
Links to old URLs keep working: `recipes.html` redirects to its new section,
and links to
in-page anchors that moved (for example `build.html#image-build-pypi`) are
redirected by a
small script to their new pages.
New examples (`extending/slim-with-providers`,
`customizing/selected-extras.sh`) are picked up by
the image example tests; `update_versions.py` now keeps the `slim-` prefix
when it bumps the
`FROM` line.
Checked locally: `breeze build-docs docker-stack` passes, and every redirect
target exists in
the built docs.
### Screenshots
<!-- drag & drop the screenshots from files/pr-screenshots here -->
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Code (Opus 5)
Generated-by: Claude Code (Opus 5) following [the
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
