[airflow] branch main updated: Add documentation and release policy on "latest" constraints (#21093)

[po...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git


The following commit(s) were added to refs/heads/main by this push:
     new aac5a1d  Add documentation and release policy on "latest" constraints (#21093)
aac5a1d is described below

commit aac5a1dba8b2b1a2b66fd4b1271dc03170c64dfb
Author: Jarek Potiuk <ja...@potiuk.com>
AuthorDate: Tue Jan 25 12:16:55 2022 +0100

    Add documentation and release policy on "latest" constraints (#21093)
---
 dev/README_RELEASE_AIRFLOW.md                             | 10 +++++++++-
 docs/apache-airflow/installation/installing-from-pypi.rst |  7 +++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/dev/README_RELEASE_AIRFLOW.md b/dev/README_RELEASE_AIRFLOW.md
index f81fb23..464f45a 100644
--- a/dev/README_RELEASE_AIRFLOW.md
+++ b/dev/README_RELEASE_AIRFLOW.md
@@ -156,7 +156,7 @@ For now this is done manually, example run  `git log --oneline v2-2-test..HEAD -
     popd
     ```
 
-- Tag & Push the latest constraints files. This pushes constraints with rc suffix (this is expected)!
+- Tag & Push the constraints files. This pushes constraints with rc suffix (this is expected)!
 
     ```shell script
     git checkout origin/constraints-${VERSION_BRANCH}
@@ -298,6 +298,7 @@ protected_branches:
    git push origin tag constraints-${BRANCH_PREFIX}
    ```
 
+
 ## Prepare PyPI convenience "snapshot" packages
 
 At this point we have the artifact that we vote on, but as a convenience to developers we also want to
@@ -796,6 +797,13 @@ At this point we release an official package:
     git push origin tag "constraints-${VERSION}"
     ```
 
+- In case you release "latest stable" version, also update "latest" constraints
+
+    ```shell script
+    git tag -f -s "constraints-latest" -m "Latest constraints set to Apache Airflow ${VERSION}"
+    git push origin tag "constraints-latest"
+    ```
+
 - Push Tag for the final version
 
     This step should only be done now and not before, because it triggers an automated build of
diff --git a/docs/apache-airflow/installation/installing-from-pypi.rst b/docs/apache-airflow/installation/installing-from-pypi.rst
index 0f4a0c5..82dc838 100644
--- a/docs/apache-airflow/installation/installing-from-pypi.rst
+++ b/docs/apache-airflow/installation/installing-from-pypi.rst
@@ -81,6 +81,13 @@ You can create the URL to the file substituting the variables in the template be
 
   https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-no-providers-${PYTHON_VERSION}.txt
 
+You can also use "latest" as version when you install "latest" stable version of Airflow. The "latest"
+constraints always points to the "latest" released Airflow version constraints:
+
+.. code-block::
+
+  https://raw.githubusercontent.com/apache/airflow/constraints-latest/constraints-3.7.txt
+
 Installation and upgrade scenarios
 ''''''''''''''''''''''''''''''''''