From 767705243aeea8f5a07f55e789ed4e0cfa7a92aa Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sun, 16 Nov 2025 23:58:02 +0100
Subject: [PATCH] Synchronize description of official vs. convenience packages
 in source installs

I noticed one more inconsistency between source packages vs. whl and sdist
distribution source installation between providers, airflow-ctl and airflow-core.

This PR generally synchronizes the description and usage of "|version|"
placeholder.
---
 .../installation/installing-from-sources.rst  | 24 +++++++++----------
 .../installation/installing-from-sources.rst  | 13 ++++++----
 .../doc/09_release_management_tasks.rst       |  2 +-
 3 files changed, 21 insertions(+), 18 deletions(-)

diff --git a/airflow-core/docs/installation/installing-from-sources.rst b/airflow-core/docs/installation/installing-from-sources.rst
index 71272e81b967e..6bb7f8c34d331 100644
--- a/airflow-core/docs/installation/installing-from-sources.rst
+++ b/airflow-core/docs/installation/installing-from-sources.rst
@@ -28,19 +28,17 @@ Released packages
     You can choose different version of Airflow by selecting a different version from the drop-down at
     the top-left of the page.
 
-The ``source``, ``sdist`` and ``whl`` packages released are the "official" sources of installation that you
-can use if you want to verify the origin of the packages and want to verify checksums and signatures of
-the packages. The packages are available via the
-`Official Apache Software Foundation Downloads <https://dlcdn.apache.org/>`_
-
-As of version 2.8 Airflow follows PEP 517/518 and uses ``pyproject.toml`` file to define build dependencies
-and build process and it requires relatively modern versions of packaging tools to get Airflow built from
-local sources or ``sdist`` packages, as PEP 517 compliant build hooks are used to determine dynamic build
-dependencies. In case of ``pip``, it means that at least version 22.1.0 is needed (released at the beginning of
-2022) to build or install Airflow from sources. This does not affect the ability of installing Airflow from
-released wheel packages.
-
-The |version| downloads of Airflow® are available at:
+The Source packages are official packages of the Apache Software Foundation - and the ones that you can
+use is you want to build the packages yourself from the source code and be sure that the provenance of
+the packages is verified and matches the source code from the repository and you can verify the
+checksums and signatures of the packages.
+
+The ``sdist`` and ``whl`` packages released are the convenience packages - of installation also installed from
+the same sources and you can still verify the origin of the packages and want to verify checksums and
+signatures of the packages. The packages are available via the Official Apache Software Foundations Downloads
+`Official Apache Software Foundations Downloads <https://dlcdn.apache.org/>`_
+
+The ``|version|`` downloads of Airflow® are available at:
 
 .. jinja:: official_download_page
 
diff --git a/airflow-ctl/docs/installation/installing-from-sources.rst b/airflow-ctl/docs/installation/installing-from-sources.rst
index 2d2f9a421f515..8f13d381db529 100644
--- a/airflow-ctl/docs/installation/installing-from-sources.rst
+++ b/airflow-ctl/docs/installation/installing-from-sources.rst
@@ -28,12 +28,17 @@ Released packages
     You can choose different version of Airflow by selecting a different version from the drop-down at
     the top-left of the page.
 
-The ``source``, ``sdist`` and ``whl`` packages released are the "official" sources of installation that you
-can use if you want to verify the origin of the packages and want to verify checksums and signatures of
-the packages. The packages are available via the
+The Source packages are official packages of the Apache Software Foundation - and the ones that you can
+use is you want to build the packages yourself from the source code and be sure that the provenance of
+the packages is verified and matches the source code from the repository and you can verify the
+checksums and signatures of the packages.
+
+The ``sdist`` and ``whl`` packages released are the convenience packages - of installation also installed from
+the same sources and you can still verify the origin of the packages and want to verify checksums and
+signatures of the packages. The packages are available via the Official Apache Software Foundations Downloads
 `Official Apache Software Foundations Downloads <https://dlcdn.apache.org/>`_
 
-The {{ airflowctl_version }} downloads of Airflow Ctl are available at:
+The ``|version|`` downloads of Airflow Ctl are available at:
 
 .. jinja:: official_download_page
 
diff --git a/dev/breeze/doc/09_release_management_tasks.rst b/dev/breeze/doc/09_release_management_tasks.rst
index 5e12d1a209035..20a7b6378a0f1 100644
--- a/dev/breeze/doc/09_release_management_tasks.rst
+++ b/dev/breeze/doc/09_release_management_tasks.rst
@@ -428,7 +428,7 @@ Installing providers
 """"""""""""""""""""
 
 In some cases we want to just see if the providers generated can be installed with Airflow without
-verifying them. This happens automatically on CI for sdist packages but you can also run it manually if you
+verifying them. This happens automatically on CI for ``sdist`` packages but you can also run it manually if you
 just prepared providers and they are present in ``dist`` folder.
 
 .. code-block:: bash
