You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by po...@apache.org on 2023/06/27 17:05:44 UTC
[airflow] branch main updated: Improve provider documentation and README structure (#32125)
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 09d4718d3a Improve provider documentation and README structure (#32125)
09d4718d3a is described below
commit 09d4718d3a46aecf3355d14d3d23022002f4a818
Author: Jarek Potiuk <ja...@potiuk.com>
AuthorDate: Tue Jun 27 19:05:35 2023 +0200
Improve provider documentation and README structure (#32125)
The changelong in provider docs has been part of the README which
became part of the page displayed in `PyPI` as well as the main
page displayed when you want to see provider documentation. This
was fine when the changelog was short, but with providers history
growing, the main page became longer and longer and the generated
index on the right side (from the changelog) became less and less
usable, and changelog itself became far less discoverable.
This change introduces another approach. Changelog gets its
own, separate page and it has quite a few positive consequences:
1) we can add separate "Changelog" URL in PyPI so that it is
prominently visible at the TOC in PyPI URLS
2) we can link to the changelog easily from stable page - without
worrrying which version we link to
3) the README file is part of the package so fixing the changelog
in case of a doc-only mistake will not fix the PyPI page (it
will only be fixed in future releases)
4) the link tree on the right side of the provider index page becomes back
usable
5) the left-side TOD on the provider's index page containes two
prominent links that were missing: Home (back to the index provider
page), Changelog, and Security - all under "Basics" link
6) The TOC is not repeated in the index page itself, making the content
immediately visible rather than having to scroll trough the long
TOC (in some cases like amazon the TOC was reallly long).
---
airflow/providers/airbyte/CHANGELOG.rst | 6 +-
airflow/providers/alibaba/CHANGELOG.rst | 6 +-
airflow/providers/amazon/CHANGELOG.rst | 6 +-
airflow/providers/apache/beam/CHANGELOG.rst | 6 +-
airflow/providers/apache/cassandra/CHANGELOG.rst | 6 +-
airflow/providers/apache/drill/CHANGELOG.rst | 6 +-
airflow/providers/apache/druid/CHANGELOG.rst | 6 +-
airflow/providers/apache/flink/CHANGELOG.rst | 6 +-
airflow/providers/apache/hdfs/CHANGELOG.rst | 6 +-
airflow/providers/apache/hive/CHANGELOG.rst | 6 +-
airflow/providers/apache/impala/CHANGELOG.rst | 6 +-
airflow/providers/apache/kafka/CHANGELOG.rst | 6 +-
airflow/providers/apache/kylin/CHANGELOG.rst | 6 +-
airflow/providers/apache/livy/CHANGELOG.rst | 6 +-
airflow/providers/apache/pig/CHANGELOG.rst | 6 +-
airflow/providers/apache/pinot/CHANGELOG.rst | 6 +-
airflow/providers/apache/spark/CHANGELOG.rst | 6 +-
airflow/providers/apache/sqoop/CHANGELOG.rst | 6 +-
airflow/providers/apprise/CHANGELOG.rst | 2 +-
airflow/providers/apprise/__init__.py | 17 ++
airflow/providers/arangodb/CHANGELOG.rst | 6 +-
airflow/providers/asana/CHANGELOG.rst | 6 +-
airflow/providers/atlassian/jira/CHANGELOG.rst | 6 +-
airflow/providers/celery/CHANGELOG.rst | 6 +-
airflow/providers/cloudant/CHANGELOG.rst | 6 +-
airflow/providers/cncf/kubernetes/CHANGELOG.rst | 6 +-
airflow/providers/common/sql/CHANGELOG.rst | 6 +-
airflow/providers/databricks/CHANGELOG.rst | 6 +-
airflow/providers/datadog/CHANGELOG.rst | 6 +-
airflow/providers/dbt/cloud/CHANGELOG.rst | 6 +-
airflow/providers/dingding/CHANGELOG.rst | 6 +-
airflow/providers/discord/CHANGELOG.rst | 6 +-
airflow/providers/docker/CHANGELOG.rst | 6 +-
airflow/providers/elasticsearch/CHANGELOG.rst | 7 +-
airflow/providers/exasol/CHANGELOG.rst | 6 +-
airflow/providers/facebook/CHANGELOG.rst | 6 +-
airflow/providers/ftp/CHANGELOG.rst | 6 +-
airflow/providers/github/CHANGELOG.rst | 6 +-
airflow/providers/google/CHANGELOG.rst | 6 +-
airflow/providers/grpc/CHANGELOG.rst | 6 +-
airflow/providers/hashicorp/CHANGELOG.rst | 6 +-
airflow/providers/http/CHANGELOG.rst | 6 +-
airflow/providers/imap/CHANGELOG.rst | 6 +-
airflow/providers/influxdb/CHANGELOG.rst | 6 +-
airflow/providers/jdbc/CHANGELOG.rst | 6 +-
airflow/providers/jenkins/CHANGELOG.rst | 6 +-
airflow/providers/microsoft/azure/CHANGELOG.rst | 6 +-
airflow/providers/microsoft/mssql/CHANGELOG.rst | 6 +-
airflow/providers/microsoft/psrp/CHANGELOG.rst | 6 +-
airflow/providers/microsoft/winrm/CHANGELOG.rst | 6 +-
airflow/providers/mongo/CHANGELOG.rst | 6 +-
airflow/providers/mysql/CHANGELOG.rst | 6 +-
airflow/providers/neo4j/CHANGELOG.rst | 6 +-
airflow/providers/odbc/CHANGELOG.rst | 6 +-
airflow/providers/openfaas/CHANGELOG.rst | 6 +-
airflow/providers/openlineage/CHANGELOG.rst | 6 +-
airflow/providers/opsgenie/CHANGELOG.rst | 6 +-
airflow/providers/oracle/CHANGELOG.rst | 6 +-
airflow/providers/pagerduty/CHANGELOG.rst | 6 +-
airflow/providers/papermill/CHANGELOG.rst | 6 +-
airflow/providers/plexus/CHANGELOG.rst | 6 +-
airflow/providers/postgres/CHANGELOG.rst | 6 +-
airflow/providers/presto/CHANGELOG.rst | 6 +-
airflow/providers/qubole/CHANGELOG.rst | 6 +-
airflow/providers/redis/CHANGELOG.rst | 6 +-
airflow/providers/salesforce/CHANGELOG.rst | 6 +-
airflow/providers/samba/CHANGELOG.rst | 6 +-
airflow/providers/segment/CHANGELOG.rst | 6 +-
airflow/providers/sendgrid/CHANGELOG.rst | 6 +-
airflow/providers/sftp/CHANGELOG.rst | 6 +-
airflow/providers/singularity/CHANGELOG.rst | 6 +-
airflow/providers/slack/CHANGELOG.rst | 6 +-
airflow/providers/smtp/CHANGELOG.rst | 6 +-
airflow/providers/snowflake/CHANGELOG.rst | 6 +-
airflow/providers/sqlite/CHANGELOG.rst | 6 +-
airflow/providers/ssh/CHANGELOG.rst | 6 +-
airflow/providers/tableau/CHANGELOG.rst | 6 +-
airflow/providers/tabular/CHANGELOG.rst | 6 +-
airflow/providers/telegram/CHANGELOG.rst | 6 +-
airflow/providers/trino/CHANGELOG.rst | 6 +-
airflow/providers/vertica/CHANGELOG.rst | 6 +-
airflow/providers/yandex/CHANGELOG.rst | 6 +-
airflow/providers/zendesk/CHANGELOG.rst | 6 +-
.../commands/release_management_commands.py | 8 +
.../commands/release_management_commands_config.py | 1 +
.../src/airflow_breeze/params/shell_params.py | 1 +
.../airflow_breeze/utils/docker_command_utils.py | 2 +
.../PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2 | 46 ++++++
.../PROVIDER_INDEX_TEMPLATE.rst.jinja2 | 3 +-
.../PROVIDER_README_TEMPLATE.rst.jinja2 | 20 ++-
.../PROVIDER_SECURITY_TEMPLATE.rst.jinja2 | 62 +++++++
dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 | 1 +
dev/provider_packages/prepare_provider_packages.py | 180 ++++++++++++++++-----
.../apache-airflow-providers-airbyte/changelog.rst | 8 +-
docs/apache-airflow-providers-airbyte/index.rst | 18 ++-
docs/apache-airflow-providers-airbyte/security.rst | 38 +++++
.../apache-airflow-providers-alibaba/changelog.rst | 8 +-
docs/apache-airflow-providers-alibaba/index.rst | 18 ++-
docs/apache-airflow-providers-alibaba/security.rst | 38 +++++
.../apache-airflow-providers-amazon/changelog.rst | 8 +-
docs/apache-airflow-providers-amazon/index.rst | 23 +--
docs/apache-airflow-providers-amazon/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-apache-beam/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 17 +-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-apache-hdfs/index.rst | 16 +-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-apache-hive/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 17 +-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-apache-livy/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-apache-pig/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 17 +-
.../security.rst | 38 +++++
.../apache-airflow-providers-apprise/changelog.rst | 8 +-
docs/apache-airflow-providers-apprise/index.rst | 58 ++++++-
docs/apache-airflow-providers-apprise/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-arangodb/index.rst | 18 ++-
.../apache-airflow-providers-arangodb/security.rst | 38 +++++
.../apache-airflow-providers-asana/changelog.rst | 8 +-
docs/apache-airflow-providers-asana/index.rst | 18 ++-
docs/apache-airflow-providers-asana/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 16 +-
.../security.rst | 38 +++++
.../apache-airflow-providers-celery/changelog.rst | 8 +-
docs/apache-airflow-providers-celery/index.rst | 15 +-
docs/apache-airflow-providers-celery/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-cloudant/index.rst | 15 +-
.../apache-airflow-providers-cloudant/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-common-sql/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-databricks/index.rst | 18 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-datadog/changelog.rst | 8 +-
docs/apache-airflow-providers-datadog/index.rst | 17 +-
docs/apache-airflow-providers-datadog/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-dbt-cloud/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-dingding/index.rst | 18 ++-
.../apache-airflow-providers-dingding/security.rst | 38 +++++
.../apache-airflow-providers-discord/changelog.rst | 8 +-
docs/apache-airflow-providers-discord/index.rst | 15 +-
docs/apache-airflow-providers-discord/security.rst | 38 +++++
.../apache-airflow-providers-docker/changelog.rst | 8 +-
docs/apache-airflow-providers-docker/index.rst | 17 +-
docs/apache-airflow-providers-docker/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 24 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-exasol/changelog.rst | 8 +-
docs/apache-airflow-providers-exasol/index.rst | 16 +-
docs/apache-airflow-providers-exasol/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-facebook/index.rst | 16 +-
.../apache-airflow-providers-facebook/security.rst | 38 +++++
.../apache-airflow-providers-ftp/changelog.rst | 8 +-
docs/apache-airflow-providers-ftp/index.rst | 19 ++-
docs/apache-airflow-providers-ftp/security.rst | 38 +++++
.../apache-airflow-providers-github/changelog.rst | 8 +-
docs/apache-airflow-providers-github/index.rst | 19 ++-
docs/apache-airflow-providers-github/security.rst | 38 +++++
.../apache-airflow-providers-google/changelog.rst | 8 +-
docs/apache-airflow-providers-google/index.rst | 20 ++-
docs/apache-airflow-providers-google/security.rst | 38 +++++
.../apache-airflow-providers-grpc/changelog.rst | 8 +-
.../connections/index.rst | 11 +-
docs/apache-airflow-providers-grpc/index.rst | 19 ++-
docs/apache-airflow-providers-grpc/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-hashicorp/index.rst | 17 +-
.../security.rst | 38 +++++
.../apache-airflow-providers-http/changelog.rst | 8 +-
docs/apache-airflow-providers-http/index.rst | 18 ++-
docs/apache-airflow-providers-http/security.rst | 38 +++++
.../apache-airflow-providers-imap/changelog.rst | 8 +-
docs/apache-airflow-providers-imap/index.rst | 16 +-
docs/apache-airflow-providers-imap/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-influxdb/index.rst | 19 ++-
.../apache-airflow-providers-influxdb/security.rst | 38 +++++
.../apache-airflow-providers-jdbc/changelog.rst | 8 +-
docs/apache-airflow-providers-jdbc/index.rst | 18 ++-
docs/apache-airflow-providers-jdbc/security.rst | 38 +++++
.../apache-airflow-providers-jenkins/changelog.rst | 8 +-
docs/apache-airflow-providers-jenkins/index.rst | 19 ++-
docs/apache-airflow-providers-jenkins/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 17 +-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
.../index.rst | 18 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-mongo/changelog.rst | 8 +-
docs/apache-airflow-providers-mongo/index.rst | 16 +-
docs/apache-airflow-providers-mongo/security.rst | 38 +++++
.../apache-airflow-providers-mysql/changelog.rst | 8 +-
docs/apache-airflow-providers-mysql/index.rst | 18 ++-
docs/apache-airflow-providers-mysql/security.rst | 38 +++++
.../apache-airflow-providers-neo4j/changelog.rst | 8 +-
docs/apache-airflow-providers-neo4j/index.rst | 18 ++-
docs/apache-airflow-providers-neo4j/security.rst | 38 +++++
.../apache-airflow-providers-odbc/changelog.rst | 8 +-
docs/apache-airflow-providers-odbc/index.rst | 16 +-
docs/apache-airflow-providers-odbc/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-openfaas/index.rst | 16 +-
.../apache-airflow-providers-openfaas/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-openlineage/index.rst | 18 ++-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-opsgenie/index.rst | 18 ++-
.../apache-airflow-providers-opsgenie/security.rst | 38 +++++
.../apache-airflow-providers-oracle/changelog.rst | 8 +-
docs/apache-airflow-providers-oracle/index.rst | 17 +-
docs/apache-airflow-providers-oracle/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-pagerduty/index.rst | 17 +-
.../security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-papermill/index.rst | 18 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-plexus/changelog.rst | 8 +-
docs/apache-airflow-providers-plexus/index.rst | 17 +-
docs/apache-airflow-providers-plexus/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-postgres/index.rst | 18 ++-
.../apache-airflow-providers-postgres/security.rst | 38 +++++
.../apache-airflow-providers-presto/changelog.rst | 8 +-
docs/apache-airflow-providers-presto/index.rst | 18 ++-
docs/apache-airflow-providers-presto/security.rst | 38 +++++
.../apache-airflow-providers-qubole/changelog.rst | 8 +-
docs/apache-airflow-providers-qubole/index.rst | 18 ++-
docs/apache-airflow-providers-qubole/security.rst | 38 +++++
.../apache-airflow-providers-redis/changelog.rst | 8 +-
docs/apache-airflow-providers-redis/index.rst | 17 +-
docs/apache-airflow-providers-redis/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-salesforce/index.rst | 18 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-samba/changelog.rst | 8 +-
docs/apache-airflow-providers-samba/index.rst | 16 +-
docs/apache-airflow-providers-samba/security.rst | 38 +++++
.../apache-airflow-providers-segment/changelog.rst | 8 +-
docs/apache-airflow-providers-segment/index.rst | 16 +-
docs/apache-airflow-providers-segment/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-sendgrid/index.rst | 16 +-
.../apache-airflow-providers-sendgrid/security.rst | 38 +++++
.../apache-airflow-providers-sftp/changelog.rst | 8 +-
docs/apache-airflow-providers-sftp/index.rst | 16 +-
docs/apache-airflow-providers-sftp/security.rst | 38 +++++
.../changelog.rst | 8 +-
.../apache-airflow-providers-singularity/index.rst | 17 +-
.../security.rst | 38 +++++
.../apache-airflow-providers-slack/changelog.rst | 8 +-
docs/apache-airflow-providers-slack/index.rst | 19 ++-
docs/apache-airflow-providers-slack/security.rst | 38 +++++
.../apache-airflow-providers-smtp/changelog.rst | 8 +-
docs/apache-airflow-providers-smtp/index.rst | 16 +-
docs/apache-airflow-providers-smtp/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-snowflake/index.rst | 18 ++-
.../security.rst | 38 +++++
.../apache-airflow-providers-sqlite/changelog.rst | 8 +-
docs/apache-airflow-providers-sqlite/index.rst | 18 ++-
docs/apache-airflow-providers-sqlite/security.rst | 38 +++++
.../apache-airflow-providers-ssh/changelog.rst | 8 +-
docs/apache-airflow-providers-ssh/index.rst | 17 +-
docs/apache-airflow-providers-ssh/security.rst | 38 +++++
.../apache-airflow-providers-tableau/changelog.rst | 8 +-
docs/apache-airflow-providers-tableau/index.rst | 17 +-
docs/apache-airflow-providers-tableau/security.rst | 38 +++++
.../apache-airflow-providers-tabular/changelog.rst | 8 +-
docs/apache-airflow-providers-tabular/index.rst | 17 +-
docs/apache-airflow-providers-tabular/security.rst | 38 +++++
.../changelog.rst | 8 +-
docs/apache-airflow-providers-telegram/index.rst | 18 ++-
.../apache-airflow-providers-telegram/security.rst | 38 +++++
.../apache-airflow-providers-trino/changelog.rst | 8 +-
docs/apache-airflow-providers-trino/index.rst | 18 ++-
docs/apache-airflow-providers-trino/security.rst | 38 +++++
.../apache-airflow-providers-vertica/changelog.rst | 8 +-
docs/apache-airflow-providers-vertica/index.rst | 16 +-
docs/apache-airflow-providers-vertica/security.rst | 38 +++++
docs/apache-airflow-providers-yandex/index.rst | 16 +-
.../apache-airflow-providers-zendesk/changelog.rst | 8 +-
docs/apache-airflow-providers-zendesk/index.rst | 17 +-
docs/apache-airflow-providers-zendesk/security.rst | 38 +++++
docs/conf.py | 9 +-
images/breeze/output-commands-hash.txt | 4 +-
...e-management_prepare-provider-documentation.svg | 52 +++---
scripts/ci/docker-compose/_docker.env | 1 +
scripts/ci/docker-compose/base.yml | 1 +
...re_commit_check_system_tests_hidden_in_index.py | 1 +
344 files changed, 5135 insertions(+), 980 deletions(-)
diff --git a/airflow/providers/airbyte/CHANGELOG.rst b/airflow/providers/airbyte/CHANGELOG.rst
index 271c689430..6d8f34d5cd 100644
--- a/airflow/providers/airbyte/CHANGELOG.rst
+++ b/airflow/providers/airbyte/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-airbyte``
+--------------------------------------------------
3.3.1
diff --git a/airflow/providers/alibaba/CHANGELOG.rst b/airflow/providers/alibaba/CHANGELOG.rst
index 3c73089313..be0b33e07a 100644
--- a/airflow/providers/alibaba/CHANGELOG.rst
+++ b/airflow/providers/alibaba/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-alibaba``
+--------------------------------------------------
2.4.1
.....
diff --git a/airflow/providers/amazon/CHANGELOG.rst b/airflow/providers/amazon/CHANGELOG.rst
index 906de481a7..ea6abb7c61 100644
--- a/airflow/providers/amazon/CHANGELOG.rst
+++ b/airflow/providers/amazon/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-amazon``
+-------------------------------------------------
8.2.0
.....
diff --git a/airflow/providers/apache/beam/CHANGELOG.rst b/airflow/providers/apache/beam/CHANGELOG.rst
index 72ce0e4fe0..495fba99e9 100644
--- a/airflow/providers/apache/beam/CHANGELOG.rst
+++ b/airflow/providers/apache/beam/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-beam``
+------------------------------------------------------
5.1.1
.....
diff --git a/airflow/providers/apache/cassandra/CHANGELOG.rst b/airflow/providers/apache/cassandra/CHANGELOG.rst
index 69ddcff864..00bfcb83f8 100644
--- a/airflow/providers/apache/cassandra/CHANGELOG.rst
+++ b/airflow/providers/apache/cassandra/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-cassandra``
+-----------------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/apache/drill/CHANGELOG.rst b/airflow/providers/apache/drill/CHANGELOG.rst
index 1be86afa26..60df655ec4 100644
--- a/airflow/providers/apache/drill/CHANGELOG.rst
+++ b/airflow/providers/apache/drill/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-drill``
+-------------------------------------------------------
2.4.1
diff --git a/airflow/providers/apache/druid/CHANGELOG.rst b/airflow/providers/apache/druid/CHANGELOG.rst
index 7285306f81..9a95a041ef 100644
--- a/airflow/providers/apache/druid/CHANGELOG.rst
+++ b/airflow/providers/apache/druid/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-druid``
+-------------------------------------------------------
3.4.1
.....
diff --git a/airflow/providers/apache/flink/CHANGELOG.rst b/airflow/providers/apache/flink/CHANGELOG.rst
index 38ba08d809..40af6d54d4 100644
--- a/airflow/providers/apache/flink/CHANGELOG.rst
+++ b/airflow/providers/apache/flink/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-flink``
+-------------------------------------------------------
1.1.1
.....
diff --git a/airflow/providers/apache/hdfs/CHANGELOG.rst b/airflow/providers/apache/hdfs/CHANGELOG.rst
index c8615f3db2..7a8000b202 100644
--- a/airflow/providers/apache/hdfs/CHANGELOG.rst
+++ b/airflow/providers/apache/hdfs/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-hdfs``
+------------------------------------------------------
4.1.0
-----
diff --git a/airflow/providers/apache/hive/CHANGELOG.rst b/airflow/providers/apache/hive/CHANGELOG.rst
index a5ffc8dd45..87c44ca909 100644
--- a/airflow/providers/apache/hive/CHANGELOG.rst
+++ b/airflow/providers/apache/hive/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-hive``
+------------------------------------------------------
6.1.1
diff --git a/airflow/providers/apache/impala/CHANGELOG.rst b/airflow/providers/apache/impala/CHANGELOG.rst
index b94522be04..95e6fca155 100644
--- a/airflow/providers/apache/impala/CHANGELOG.rst
+++ b/airflow/providers/apache/impala/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-impala``
+--------------------------------------------------------
1.1.1
.....
diff --git a/airflow/providers/apache/kafka/CHANGELOG.rst b/airflow/providers/apache/kafka/CHANGELOG.rst
index 4c467c6822..3bde0c11de 100644
--- a/airflow/providers/apache/kafka/CHANGELOG.rst
+++ b/airflow/providers/apache/kafka/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-kafka``
+-------------------------------------------------------
1.1.1
.....
diff --git a/airflow/providers/apache/kylin/CHANGELOG.rst b/airflow/providers/apache/kylin/CHANGELOG.rst
index 6b145026f2..a40ddec032 100644
--- a/airflow/providers/apache/kylin/CHANGELOG.rst
+++ b/airflow/providers/apache/kylin/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-kylin``
+-------------------------------------------------------
3.2.1
diff --git a/airflow/providers/apache/livy/CHANGELOG.rst b/airflow/providers/apache/livy/CHANGELOG.rst
index 049172b51e..40cf764639 100644
--- a/airflow/providers/apache/livy/CHANGELOG.rst
+++ b/airflow/providers/apache/livy/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-livy``
+------------------------------------------------------
3.5.1
.....
diff --git a/airflow/providers/apache/pig/CHANGELOG.rst b/airflow/providers/apache/pig/CHANGELOG.rst
index ef7f7b932e..72ba0f4a39 100644
--- a/airflow/providers/apache/pig/CHANGELOG.rst
+++ b/airflow/providers/apache/pig/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-pig``
+-----------------------------------------------------
4.1.1
.....
diff --git a/airflow/providers/apache/pinot/CHANGELOG.rst b/airflow/providers/apache/pinot/CHANGELOG.rst
index 3f31f49320..eb49423199 100644
--- a/airflow/providers/apache/pinot/CHANGELOG.rst
+++ b/airflow/providers/apache/pinot/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-pinot``
+-------------------------------------------------------
4.1.1
diff --git a/airflow/providers/apache/spark/CHANGELOG.rst b/airflow/providers/apache/spark/CHANGELOG.rst
index 95586f99b1..2ec8794053 100644
--- a/airflow/providers/apache/spark/CHANGELOG.rst
+++ b/airflow/providers/apache/spark/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-spark``
+-------------------------------------------------------
4.1.1
.....
diff --git a/airflow/providers/apache/sqoop/CHANGELOG.rst b/airflow/providers/apache/sqoop/CHANGELOG.rst
index b9efe86dc7..a8a5dca3cd 100644
--- a/airflow/providers/apache/sqoop/CHANGELOG.rst
+++ b/airflow/providers/apache/sqoop/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-apache-sqoop``
+-------------------------------------------------------
3.2.1
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/airflow/providers/apprise/CHANGELOG.rst
index 450e8ed420..0b1586bbfa 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/airflow/providers/apprise/CHANGELOG.rst
@@ -17,6 +17,6 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
diff --git a/airflow/providers/apprise/__init__.py b/airflow/providers/apprise/__init__.py
index c88b314548..e37b88dcc9 100644
--- a/airflow/providers/apprise/__init__.py
+++ b/airflow/providers/apprise/__init__.py
@@ -22,3 +22,20 @@
# IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE
# `PROVIDER__INIT__PY_TEMPLATE.py.jinja2` IN the `dev/provider_packages` DIRECTORY
#
+from __future__ import annotations
+
+import packaging.version
+
+__all__ = ["__version__"]
+
+__version__ = "1.0.0"
+
+try:
+ from airflow import __version__ as airflow_version
+except ImportError:
+ from airflow.version import version as airflow_version
+
+if packaging.version.parse(airflow_version) < packaging.version.parse("2.4.0"):
+ raise RuntimeError(
+ f"The package `apache-airflow-providers-apprise:{__version__}` requires Apache Airflow 2.4.0+" # NOQA: E501
+ )
diff --git a/airflow/providers/arangodb/CHANGELOG.rst b/airflow/providers/arangodb/CHANGELOG.rst
index 6eb420713e..e72e8963d4 100644
--- a/airflow/providers/arangodb/CHANGELOG.rst
+++ b/airflow/providers/arangodb/CHANGELOG.rst
@@ -18,12 +18,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-arangodb``
+---------------------------------------------------
2.2.1
.....
diff --git a/airflow/providers/asana/CHANGELOG.rst b/airflow/providers/asana/CHANGELOG.rst
index 5a277d5b7b..0e8de8a3a5 100644
--- a/airflow/providers/asana/CHANGELOG.rst
+++ b/airflow/providers/asana/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-asana``
+------------------------------------------------
2.2.1
.....
diff --git a/airflow/providers/atlassian/jira/CHANGELOG.rst b/airflow/providers/atlassian/jira/CHANGELOG.rst
index f15cae6ff4..3358ac28cb 100644
--- a/airflow/providers/atlassian/jira/CHANGELOG.rst
+++ b/airflow/providers/atlassian/jira/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-atlassian-jira``
+---------------------------------------------------------
2.1.1
.....
diff --git a/airflow/providers/celery/CHANGELOG.rst b/airflow/providers/celery/CHANGELOG.rst
index df1339a026..1f3b37ac2d 100644
--- a/airflow/providers/celery/CHANGELOG.rst
+++ b/airflow/providers/celery/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-celery``
+-------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/cloudant/CHANGELOG.rst b/airflow/providers/cloudant/CHANGELOG.rst
index a26ac6d68c..93fea1598d 100644
--- a/airflow/providers/cloudant/CHANGELOG.rst
+++ b/airflow/providers/cloudant/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-cloudant``
+---------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/cncf/kubernetes/CHANGELOG.rst b/airflow/providers/cncf/kubernetes/CHANGELOG.rst
index 01439ce311..bae95c0297 100644
--- a/airflow/providers/cncf/kubernetes/CHANGELOG.rst
+++ b/airflow/providers/cncf/kubernetes/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-cncf-kubernetes``
+----------------------------------------------------------
7.1.0
.....
diff --git a/airflow/providers/common/sql/CHANGELOG.rst b/airflow/providers/common/sql/CHANGELOG.rst
index 9d8e58e69a..73400cd5c6 100644
--- a/airflow/providers/common/sql/CHANGELOG.rst
+++ b/airflow/providers/common/sql/CHANGELOG.rst
@@ -16,13 +16,13 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-common-sql``
+-----------------------------------------------------
1.5.2
.....
diff --git a/airflow/providers/databricks/CHANGELOG.rst b/airflow/providers/databricks/CHANGELOG.rst
index 53b1b211d5..de5a5df4cc 100644
--- a/airflow/providers/databricks/CHANGELOG.rst
+++ b/airflow/providers/databricks/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-databricks``
+-----------------------------------------------------
4.3.0
.....
diff --git a/airflow/providers/datadog/CHANGELOG.rst b/airflow/providers/datadog/CHANGELOG.rst
index 84df803c1a..d7e966661e 100644
--- a/airflow/providers/datadog/CHANGELOG.rst
+++ b/airflow/providers/datadog/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-datadog``
+--------------------------------------------------
3.3.1
.....
diff --git a/airflow/providers/dbt/cloud/CHANGELOG.rst b/airflow/providers/dbt/cloud/CHANGELOG.rst
index 92cbb954c9..e87ecaf4b8 100644
--- a/airflow/providers/dbt/cloud/CHANGELOG.rst
+++ b/airflow/providers/dbt/cloud/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-dbt-cloud``
+----------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/dingding/CHANGELOG.rst b/airflow/providers/dingding/CHANGELOG.rst
index 23d4a92d56..78620c282a 100644
--- a/airflow/providers/dingding/CHANGELOG.rst
+++ b/airflow/providers/dingding/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-dingding``
+---------------------------------------------------
3.2.1
diff --git a/airflow/providers/discord/CHANGELOG.rst b/airflow/providers/discord/CHANGELOG.rst
index a8f3d977e8..23b9b970dc 100644
--- a/airflow/providers/discord/CHANGELOG.rst
+++ b/airflow/providers/discord/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-discord``
+--------------------------------------------------
3.3.0
.....
diff --git a/airflow/providers/docker/CHANGELOG.rst b/airflow/providers/docker/CHANGELOG.rst
index b7df5fa08e..8d52fb8577 100644
--- a/airflow/providers/docker/CHANGELOG.rst
+++ b/airflow/providers/docker/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-docker``
+-------------------------------------------------
3.7.1
.....
diff --git a/airflow/providers/elasticsearch/CHANGELOG.rst b/airflow/providers/elasticsearch/CHANGELOG.rst
index e0f2aa0894..bb489325a6 100644
--- a/airflow/providers/elasticsearch/CHANGELOG.rst
+++ b/airflow/providers/elasticsearch/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-elasticsearch``
+--------------------------------------------------------
5.0.0
.....
@@ -30,6 +30,7 @@ Changelog
.. note::
Deprecate non-official elasticsearch libraries. Only the official elasticsearch library was used
+
4.5.1
.....
diff --git a/airflow/providers/exasol/CHANGELOG.rst b/airflow/providers/exasol/CHANGELOG.rst
index 5fb93a897e..a6bbf16595 100644
--- a/airflow/providers/exasol/CHANGELOG.rst
+++ b/airflow/providers/exasol/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-exasol``
+-------------------------------------------------
4.2.1
.....
diff --git a/airflow/providers/facebook/CHANGELOG.rst b/airflow/providers/facebook/CHANGELOG.rst
index ee7574fc46..4aca578d13 100644
--- a/airflow/providers/facebook/CHANGELOG.rst
+++ b/airflow/providers/facebook/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-facebook``
+---------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/ftp/CHANGELOG.rst b/airflow/providers/ftp/CHANGELOG.rst
index e5aec43f86..d1377ea115 100644
--- a/airflow/providers/ftp/CHANGELOG.rst
+++ b/airflow/providers/ftp/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-ftp``
+----------------------------------------------
3.4.2
.....
diff --git a/airflow/providers/github/CHANGELOG.rst b/airflow/providers/github/CHANGELOG.rst
index d9ee1b1d19..6e0fcca472 100644
--- a/airflow/providers/github/CHANGELOG.rst
+++ b/airflow/providers/github/CHANGELOG.rst
@@ -18,12 +18,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-github``
+-------------------------------------------------
2.3.1
.....
diff --git a/airflow/providers/google/CHANGELOG.rst b/airflow/providers/google/CHANGELOG.rst
index 95942d6e6d..7c39d83e3c 100644
--- a/airflow/providers/google/CHANGELOG.rst
+++ b/airflow/providers/google/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-google``
+-------------------------------------------------
10.2.0
......
diff --git a/airflow/providers/grpc/CHANGELOG.rst b/airflow/providers/grpc/CHANGELOG.rst
index c71b34b417..b65a9b0a75 100644
--- a/airflow/providers/grpc/CHANGELOG.rst
+++ b/airflow/providers/grpc/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-grpc``
+-----------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/hashicorp/CHANGELOG.rst b/airflow/providers/hashicorp/CHANGELOG.rst
index 38dc1396da..88ca2da025 100644
--- a/airflow/providers/hashicorp/CHANGELOG.rst
+++ b/airflow/providers/hashicorp/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-hashicorp``
+----------------------------------------------------
3.4.1
.....
diff --git a/airflow/providers/http/CHANGELOG.rst b/airflow/providers/http/CHANGELOG.rst
index df2165460a..bab59fd533 100644
--- a/airflow/providers/http/CHANGELOG.rst
+++ b/airflow/providers/http/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-http``
+-----------------------------------------------
4.4.2
.....
diff --git a/airflow/providers/imap/CHANGELOG.rst b/airflow/providers/imap/CHANGELOG.rst
index 1dd64ab057..e5ae86a416 100644
--- a/airflow/providers/imap/CHANGELOG.rst
+++ b/airflow/providers/imap/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-imap``
+-----------------------------------------------
3.2.2
.....
diff --git a/airflow/providers/influxdb/CHANGELOG.rst b/airflow/providers/influxdb/CHANGELOG.rst
index 8a03f33a97..081456722f 100644
--- a/airflow/providers/influxdb/CHANGELOG.rst
+++ b/airflow/providers/influxdb/CHANGELOG.rst
@@ -18,12 +18,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-influxdb``
+---------------------------------------------------
2.2.1
.....
diff --git a/airflow/providers/jdbc/CHANGELOG.rst b/airflow/providers/jdbc/CHANGELOG.rst
index b54dcaabad..a8a079568b 100644
--- a/airflow/providers/jdbc/CHANGELOG.rst
+++ b/airflow/providers/jdbc/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-jdbc``
+-----------------------------------------------
4.0.0
.....
diff --git a/airflow/providers/jenkins/CHANGELOG.rst b/airflow/providers/jenkins/CHANGELOG.rst
index c9054cceaf..1f9328f892 100644
--- a/airflow/providers/jenkins/CHANGELOG.rst
+++ b/airflow/providers/jenkins/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-jenkins``
+--------------------------------------------------
3.3.1
.....
diff --git a/airflow/providers/microsoft/azure/CHANGELOG.rst b/airflow/providers/microsoft/azure/CHANGELOG.rst
index e495ea31ee..87424de9b6 100644
--- a/airflow/providers/microsoft/azure/CHANGELOG.rst
+++ b/airflow/providers/microsoft/azure/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-microsoft-azure``
+----------------------------------------------------------
6.1.2
.....
diff --git a/airflow/providers/microsoft/mssql/CHANGELOG.rst b/airflow/providers/microsoft/mssql/CHANGELOG.rst
index c4c32385cd..e161e6fa33 100644
--- a/airflow/providers/microsoft/mssql/CHANGELOG.rst
+++ b/airflow/providers/microsoft/mssql/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-microsoft-mssql``
+----------------------------------------------------------
3.4.1
.....
diff --git a/airflow/providers/microsoft/psrp/CHANGELOG.rst b/airflow/providers/microsoft/psrp/CHANGELOG.rst
index 163a7a82fb..f4fcf01bd1 100644
--- a/airflow/providers/microsoft/psrp/CHANGELOG.rst
+++ b/airflow/providers/microsoft/psrp/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-microsoft-psrp``
+---------------------------------------------------------
2.3.1
.....
diff --git a/airflow/providers/microsoft/winrm/CHANGELOG.rst b/airflow/providers/microsoft/winrm/CHANGELOG.rst
index 98c8300f0a..e30d846332 100644
--- a/airflow/providers/microsoft/winrm/CHANGELOG.rst
+++ b/airflow/providers/microsoft/winrm/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-microsoft-winrm``
+----------------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/mongo/CHANGELOG.rst b/airflow/providers/mongo/CHANGELOG.rst
index 982db5719e..2b07ba58d5 100644
--- a/airflow/providers/mongo/CHANGELOG.rst
+++ b/airflow/providers/mongo/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-mongo``
+------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/mysql/CHANGELOG.rst b/airflow/providers/mysql/CHANGELOG.rst
index d9730a3535..ec482a62ec 100644
--- a/airflow/providers/mysql/CHANGELOG.rst
+++ b/airflow/providers/mysql/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-mysql``
+------------------------------------------------
5.1.1
.....
diff --git a/airflow/providers/neo4j/CHANGELOG.rst b/airflow/providers/neo4j/CHANGELOG.rst
index c4b031462b..bf1ac70446 100644
--- a/airflow/providers/neo4j/CHANGELOG.rst
+++ b/airflow/providers/neo4j/CHANGELOG.rst
@@ -18,12 +18,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-neo4j``
+------------------------------------------------
3.3.1
.....
diff --git a/airflow/providers/odbc/CHANGELOG.rst b/airflow/providers/odbc/CHANGELOG.rst
index 4acfd8996c..9e2495ef29 100644
--- a/airflow/providers/odbc/CHANGELOG.rst
+++ b/airflow/providers/odbc/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-odbc``
+-----------------------------------------------
4.0.0
.....
diff --git a/airflow/providers/openfaas/CHANGELOG.rst b/airflow/providers/openfaas/CHANGELOG.rst
index 5968d6c797..5213b63000 100644
--- a/airflow/providers/openfaas/CHANGELOG.rst
+++ b/airflow/providers/openfaas/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-openfaas``
+---------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/openlineage/CHANGELOG.rst b/airflow/providers/openlineage/CHANGELOG.rst
index 8e4a4fb2ea..c54c6ebc05 100644
--- a/airflow/providers/openlineage/CHANGELOG.rst
+++ b/airflow/providers/openlineage/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-openlineage``
+------------------------------------------------------
1.0.0
.....
diff --git a/airflow/providers/opsgenie/CHANGELOG.rst b/airflow/providers/opsgenie/CHANGELOG.rst
index 8bb16430d5..69fd938304 100644
--- a/airflow/providers/opsgenie/CHANGELOG.rst
+++ b/airflow/providers/opsgenie/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-opsgenie``
+---------------------------------------------------
5.1.1
.....
diff --git a/airflow/providers/oracle/CHANGELOG.rst b/airflow/providers/oracle/CHANGELOG.rst
index 537c48ed3b..bc7e86d76c 100644
--- a/airflow/providers/oracle/CHANGELOG.rst
+++ b/airflow/providers/oracle/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-oracle``
+-------------------------------------------------
3.7.1
.....
diff --git a/airflow/providers/pagerduty/CHANGELOG.rst b/airflow/providers/pagerduty/CHANGELOG.rst
index 349c0843cd..cddb9e34ee 100644
--- a/airflow/providers/pagerduty/CHANGELOG.rst
+++ b/airflow/providers/pagerduty/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-pagerduty``
+----------------------------------------------------
3.3.0
.....
diff --git a/airflow/providers/papermill/CHANGELOG.rst b/airflow/providers/papermill/CHANGELOG.rst
index 7494f2001d..933b456a49 100644
--- a/airflow/providers/papermill/CHANGELOG.rst
+++ b/airflow/providers/papermill/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-papermill``
+----------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/plexus/CHANGELOG.rst b/airflow/providers/plexus/CHANGELOG.rst
index 280fbb895f..d9ed577d22 100644
--- a/airflow/providers/plexus/CHANGELOG.rst
+++ b/airflow/providers/plexus/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-plexus``
+-------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/postgres/CHANGELOG.rst b/airflow/providers/postgres/CHANGELOG.rst
index 65f6a496a1..46f391a0fa 100644
--- a/airflow/providers/postgres/CHANGELOG.rst
+++ b/airflow/providers/postgres/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-postgres``
+---------------------------------------------------
5.5.1
.....
diff --git a/airflow/providers/presto/CHANGELOG.rst b/airflow/providers/presto/CHANGELOG.rst
index 7d172fa5eb..d35e42c518 100644
--- a/airflow/providers/presto/CHANGELOG.rst
+++ b/airflow/providers/presto/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-presto``
+-------------------------------------------------
5.1.1
.....
diff --git a/airflow/providers/qubole/CHANGELOG.rst b/airflow/providers/qubole/CHANGELOG.rst
index 0ef4af239f..c8c7c76aa9 100644
--- a/airflow/providers/qubole/CHANGELOG.rst
+++ b/airflow/providers/qubole/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-qubole``
+-------------------------------------------------
3.4.1
.....
diff --git a/airflow/providers/redis/CHANGELOG.rst b/airflow/providers/redis/CHANGELOG.rst
index c836a108f1..87b538ec7c 100644
--- a/airflow/providers/redis/CHANGELOG.rst
+++ b/airflow/providers/redis/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-redis``
+------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/salesforce/CHANGELOG.rst b/airflow/providers/salesforce/CHANGELOG.rst
index fe5b961b41..78505ad7c8 100644
--- a/airflow/providers/salesforce/CHANGELOG.rst
+++ b/airflow/providers/salesforce/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-salesforce``
+-----------------------------------------------------
5.4.1
.....
diff --git a/airflow/providers/samba/CHANGELOG.rst b/airflow/providers/samba/CHANGELOG.rst
index 746e88f5d7..190b1f73f7 100644
--- a/airflow/providers/samba/CHANGELOG.rst
+++ b/airflow/providers/samba/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-samba``
+------------------------------------------------
4.2.1
.....
diff --git a/airflow/providers/segment/CHANGELOG.rst b/airflow/providers/segment/CHANGELOG.rst
index 3148c8eb43..059ae0472d 100644
--- a/airflow/providers/segment/CHANGELOG.rst
+++ b/airflow/providers/segment/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-segment``
+--------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/sendgrid/CHANGELOG.rst b/airflow/providers/sendgrid/CHANGELOG.rst
index a8ee20f4e8..7e677678f5 100644
--- a/airflow/providers/sendgrid/CHANGELOG.rst
+++ b/airflow/providers/sendgrid/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-sendgrid``
+---------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/sftp/CHANGELOG.rst b/airflow/providers/sftp/CHANGELOG.rst
index 6f3891b20f..dcea4aad31 100644
--- a/airflow/providers/sftp/CHANGELOG.rst
+++ b/airflow/providers/sftp/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-sftp``
+-----------------------------------------------
4.3.1
.....
diff --git a/airflow/providers/singularity/CHANGELOG.rst b/airflow/providers/singularity/CHANGELOG.rst
index 95e463f310..1ad3b4bc1d 100644
--- a/airflow/providers/singularity/CHANGELOG.rst
+++ b/airflow/providers/singularity/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-singularity``
+------------------------------------------------------
3.2.1
.....
diff --git a/airflow/providers/slack/CHANGELOG.rst b/airflow/providers/slack/CHANGELOG.rst
index 19d70f4dcd..ca1dc3895d 100644
--- a/airflow/providers/slack/CHANGELOG.rst
+++ b/airflow/providers/slack/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-slack``
+------------------------------------------------
7.3.1
.....
diff --git a/airflow/providers/smtp/CHANGELOG.rst b/airflow/providers/smtp/CHANGELOG.rst
index 29bb4951db..103e9a73c3 100644
--- a/airflow/providers/smtp/CHANGELOG.rst
+++ b/airflow/providers/smtp/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-smtp``
+-----------------------------------------------
1.2.0
.....
diff --git a/airflow/providers/snowflake/CHANGELOG.rst b/airflow/providers/snowflake/CHANGELOG.rst
index a0272b3987..ee9fca09d8 100644
--- a/airflow/providers/snowflake/CHANGELOG.rst
+++ b/airflow/providers/snowflake/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-snowflake``
+----------------------------------------------------
4.2.0
.....
diff --git a/airflow/providers/sqlite/CHANGELOG.rst b/airflow/providers/sqlite/CHANGELOG.rst
index 723cd6347e..f84ff50a85 100644
--- a/airflow/providers/sqlite/CHANGELOG.rst
+++ b/airflow/providers/sqlite/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-sqlite``
+-------------------------------------------------
3.4.2
.....
diff --git a/airflow/providers/ssh/CHANGELOG.rst b/airflow/providers/ssh/CHANGELOG.rst
index 53f731a66c..9accc14048 100644
--- a/airflow/providers/ssh/CHANGELOG.rst
+++ b/airflow/providers/ssh/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-ssh``
+----------------------------------------------
3.7.1
.....
diff --git a/airflow/providers/tableau/CHANGELOG.rst b/airflow/providers/tableau/CHANGELOG.rst
index 86593829c3..41af7710de 100644
--- a/airflow/providers/tableau/CHANGELOG.rst
+++ b/airflow/providers/tableau/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-tableau``
+--------------------------------------------------
4.2.1
.....
diff --git a/airflow/providers/tabular/CHANGELOG.rst b/airflow/providers/tabular/CHANGELOG.rst
index 5036652714..9db36926d2 100644
--- a/airflow/providers/tabular/CHANGELOG.rst
+++ b/airflow/providers/tabular/CHANGELOG.rst
@@ -16,12 +16,12 @@
under the License.
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-tabular``
+--------------------------------------------------
1.2.1
.....
diff --git a/airflow/providers/telegram/CHANGELOG.rst b/airflow/providers/telegram/CHANGELOG.rst
index d9fc42be0d..dcd21d242f 100644
--- a/airflow/providers/telegram/CHANGELOG.rst
+++ b/airflow/providers/telegram/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-telegram``
+---------------------------------------------------
4.1.1
.....
diff --git a/airflow/providers/trino/CHANGELOG.rst b/airflow/providers/trino/CHANGELOG.rst
index 24dcf62259..7e5b05538e 100644
--- a/airflow/providers/trino/CHANGELOG.rst
+++ b/airflow/providers/trino/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-trino``
+------------------------------------------------
5.1.1
.....
diff --git a/airflow/providers/vertica/CHANGELOG.rst b/airflow/providers/vertica/CHANGELOG.rst
index d2e3c54c49..db9a5335b8 100644
--- a/airflow/providers/vertica/CHANGELOG.rst
+++ b/airflow/providers/vertica/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-vertica``
+--------------------------------------------------
3.4.1
.....
diff --git a/airflow/providers/yandex/CHANGELOG.rst b/airflow/providers/yandex/CHANGELOG.rst
index d24e063b1a..8eee1ab6c9 100644
--- a/airflow/providers/yandex/CHANGELOG.rst
+++ b/airflow/providers/yandex/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-yandex``
+-------------------------------------------------
.. note::
This release dropped support for Python 3.7
diff --git a/airflow/providers/zendesk/CHANGELOG.rst b/airflow/providers/zendesk/CHANGELOG.rst
index 5ff676b94c..3c9f67d9d0 100644
--- a/airflow/providers/zendesk/CHANGELOG.rst
+++ b/airflow/providers/zendesk/CHANGELOG.rst
@@ -17,12 +17,12 @@
.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes
and you want to add an explanation to the users on how they are supposed to deal with them.
The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+Changelog for ``apache-airflow-providers-zendex``
+-------------------------------------------------
4.3.1
.....
diff --git a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
index 234daf6fb5..2f95e73c9e 100644
--- a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
@@ -241,6 +241,12 @@ def prepare_airflow_packages(
is_flag=True,
help="Only update minimum version in __init__.py files and regenerate corresponding documentation",
)
+@click.option(
+ "--regenerate-missing-docs",
+ is_flag=True,
+ help="Only regenerate missing documentation, do not bump version. Useful if templates were added"
+ " and you need to regenerate documentation.",
+)
@option_verbose
@option_dry_run
@option_answer
@@ -250,6 +256,7 @@ def prepare_provider_documentation(
debug: bool,
packages: list[str],
only_min_version_update: bool,
+ regenerate_missing_docs: bool,
):
perform_environment_checks()
check_remote_ghcr_io_commands()
@@ -260,6 +267,7 @@ def prepare_provider_documentation(
python=DEFAULT_PYTHON_MAJOR_MINOR_VERSION,
base_branch=base_branch,
only_min_version_update=only_min_version_update,
+ regenerate_missing_docs=regenerate_missing_docs,
skip_environment_initialization=True,
)
rebuild_or_pull_ci_image_if_needed(command_params=shell_params)
diff --git a/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py b/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py
index 16995784e4..abbe671cb4 100644
--- a/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py
+++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py
@@ -101,6 +101,7 @@ RELEASE_MANAGEMENT_PARAMETERS: dict[str, list[dict[str, str | list[str]]]] = {
"--github-repository",
"--base-branch",
"--only-min-version-update",
+ "--regenerate-missing-docs",
],
}
],
diff --git a/dev/breeze/src/airflow_breeze/params/shell_params.py b/dev/breeze/src/airflow_breeze/params/shell_params.py
index cb666752bf..22c3b9057f 100644
--- a/dev/breeze/src/airflow_breeze/params/shell_params.py
+++ b/dev/breeze/src/airflow_breeze/params/shell_params.py
@@ -123,6 +123,7 @@ class ShellParams:
celery_broker: str = DEFAULT_CELERY_BROKER
celery_flower: bool = False
only_min_version_update: bool = False
+ regenerate_missing_docs: bool = False
def clone_with_test(self, test_type: str) -> ShellParams:
new_params = deepcopy(self)
diff --git a/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py b/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py
index 75d838e9d1..13cd8f060d 100644
--- a/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py
+++ b/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py
@@ -626,6 +626,7 @@ def update_expected_environment_variables(env: dict[str, str]) -> None:
set_value_to_default_if_not_set(env, "ONLY_MIN_VERSION_UPDATE", "false")
set_value_to_default_if_not_set(env, "PACKAGE_FORMAT", ALLOWED_PACKAGE_FORMATS[0])
set_value_to_default_if_not_set(env, "PYTHONDONTWRITEBYTECODE", "true")
+ set_value_to_default_if_not_set(env, "REGENERATE_MISSING_DOCS", "false")
set_value_to_default_if_not_set(env, "REMOVE_ARM_PACKAGES", "false")
set_value_to_default_if_not_set(env, "RUN_SYSTEM_TESTS", "false")
set_value_to_default_if_not_set(env, "RUN_TESTS", "false")
@@ -673,6 +674,7 @@ DERIVE_ENV_VARIABLES_FROM_ATTRIBUTES = {
"MYSQL_VERSION": "mysql_version",
"NUM_RUNS": "num_runs",
"ONLY_MIN_VERSION_UPDATE": "only_min_version_update",
+ "REGENERATE_MISSING_DOCS": "regenerate_missing_docs",
"PACKAGE_FORMAT": "package_format",
"POSTGRES_VERSION": "postgres_version",
"PYTHON_MAJOR_MINOR_VERSION": "python",
diff --git a/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2
new file mode 100644
index 0000000000..81d0e42a23
--- /dev/null
+++ b/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2
@@ -0,0 +1,46 @@
+{#
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE
+ OVERWRITTEN WHEN PREPARING PACKAGES.
+
+ IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE
+ `PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY
+
+#}
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Package ``{{ PACKAGE_PIP_NAME }}``
+{{ '-' * (12 + PACKAGE_PIP_NAME | length) }}
+
+.. include:: {{ CHANGELOG_RELATIVE_PATH }}/CHANGELOG.rst
diff --git a/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2
index 51175274ad..01a34b6118 100644
--- a/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2
+++ b/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2
@@ -25,6 +25,7 @@
#}
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +91,3 @@ You can download officially released packages and verify their checksums and sig
{%- endif %}
-
-.. include:: {{ CHANGELOG_RELATIVE_PATH }}/CHANGELOG.rst
diff --git a/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2
index 3d1751e913..4bc7887d97 100644
--- a/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2
+++ b/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2
@@ -23,6 +23,23 @@
`PROVIDER_INDEX_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY
#}
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
Package ``{{ PACKAGE_PIP_NAME }}``
@@ -77,4 +94,5 @@ You can install such cross-provider dependencies when installing from PyPI. For
{%- endif %}
-{{ CHANGELOG | safe }}
+The changelog for the provider package can be found in the
+`changelog <https://airflow.apache.org/docs/{{ PACKAGE_PIP_NAME }}/{{RELEASE}}/changelog.html>`_.
diff --git a/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2
new file mode 100644
index 0000000000..56039a7761
--- /dev/null
+++ b/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2
@@ -0,0 +1,62 @@
+{#
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE
+ OVERWRITTEN WHEN PREPARING PACKAGES.
+
+ IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE
+ `PROVIDER_SECURITY_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY
+
+#}
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 b/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2
index 5fb6a9c74d..c3fdba076b 100644
--- a/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2
+++ b/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2
@@ -51,6 +51,7 @@ classifiers =
Topic :: System :: Monitoring
project_urls=
Documentation=https://airflow.apache.org/docs/{{ PACKAGE_PIP_NAME }}/{{RELEASE}}/
+ Changelog=https://airflow.apache.org/docs/{{ PACKAGE_PIP_NAME }}/{{RELEASE}}/changelog.html
Bug Tracker=https://github.com/apache/airflow/issues
Source Code=https://github.com/apache/airflow
Slack Chat=https://s.apache.org/airflow-slack
diff --git a/dev/provider_packages/prepare_provider_packages.py b/dev/provider_packages/prepare_provider_packages.py
index 76fd3f99a1..8bf6e24852 100755
--- a/dev/provider_packages/prepare_provider_packages.py
+++ b/dev/provider_packages/prepare_provider_packages.py
@@ -43,6 +43,7 @@ from random import choice
from shutil import copyfile
from typing import Any, Generator, Iterable, NamedTuple
+import jinja2
import jsonschema
import rich_click as click
import semver as semver
@@ -61,8 +62,6 @@ MIN_AIRFLOW_VERSION = "2.4.0"
MIN_AIRFLOW_VERSION_EXCEPTIONS = {"openlineage": "2.6.0"}
INITIAL_CHANGELOG_CONTENT = """
-
-
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -80,9 +79,14 @@ INITIAL_CHANGELOG_CONTENT = """
specific language governing permissions and limitations
under the License.
+.. NOTE TO CONTRIBUTORS:
+ Please, only add notes to the Changelog just below the "Changelog for ..." header when there
+ are some breaking changes and you want to add an explanation to the users on how they are supposed
+ to deal with them. The changelog is updated and maintained semi-automatically by release manager.
-Changelog
----------
+
+Changelog for ``{{ package_name }}``
+{{ '-' * (18 + package_name | length) }}
1.0.0
.....
@@ -142,7 +146,7 @@ class ProviderPackageDetails(NamedTuple):
full_package_name: str
pypi_package_name: str
source_provider_package_path: str
- documentation_provider_package_path: str
+ documentation_provider_package_path: Path
provider_description: str
versions: list[str]
excluded_python_versions: list[str]
@@ -830,15 +834,13 @@ def get_source_package_path(provider_package_id: str) -> str:
return os.path.join(PROVIDERS_PATH, *provider_package_id.split("."))
-def get_documentation_package_path(provider_package_id: str) -> str:
+def get_documentation_package_path(provider_package_id: str) -> Path:
"""Retrieves documentation package path from package id.
:param provider_package_id: id of the package
:return: path of the documentation folder
"""
- return os.path.join(
- DOCUMENTATION_PATH, f"apache-airflow-providers-{provider_package_id.replace('.','-')}"
- )
+ return DOCUMENTATION_PATH / f"apache-airflow-providers-{provider_package_id.replace('.','-')}"
def get_generated_package_path(provider_package_id: str) -> str:
@@ -946,19 +948,21 @@ def get_all_changes_for_package(
provider_package_id: str,
verbose: bool,
base_branch: str,
+ force: bool,
) -> tuple[bool, list[list[Change]] | Change | None, str]:
"""Retrieves all changes for the package.
:param provider_package_id: provider package id
- :param base_branch: base branch to check changes in apache remote for changes
:param verbose: whether to print verbose messages
+ :param base_branch: base branch to check changes in apache remote for changes
+ :param force: whether to force the check even if the tag exists
"""
provider_details = get_provider_details(provider_package_id)
current_version = provider_details.versions[0]
current_tag_no_suffix = get_version_tag(current_version, provider_package_id)
if verbose:
console.print(f"Checking if tag '{current_tag_no_suffix}' exist.")
- if not subprocess.call(
+ if not force and not subprocess.call(
get_git_tag_check_command(current_tag_no_suffix),
cwd=provider_details.source_provider_package_path,
stderr=subprocess.DEVNULL,
@@ -1275,6 +1279,7 @@ def update_release_notes(
verbose: bool,
answer: str | None,
base_branch: str,
+ regenerate_missing_docs: bool,
) -> bool:
"""Updates generated files.
@@ -1286,10 +1291,13 @@ def update_release_notes(
:param verbose: whether to print verbose messages
:param answer: force answer to question if set.
:param base_branch: base branch to check changes in apache remote for changes
+ :param regenerate_missing_docs: whether to regenerate missing docs
:returns False if the package should be skipped, True if everything generated properly
"""
verify_provider_package(provider_package_id)
- proceed, latest_change, changes = get_all_changes_for_package(provider_package_id, verbose, base_branch)
+ proceed, latest_change, changes = get_all_changes_for_package(
+ provider_package_id, verbose, base_branch, force
+ )
if not force:
if proceed:
if not confirm("Provider marked for release. Proceed", answer=answer):
@@ -1317,7 +1325,7 @@ def update_release_notes(
elif type_of_change in [TypeOfChange.BUGFIX, TypeOfChange.FEATURE, TypeOfChange.BREAKING_CHANGE]:
add_new_version(type_of_change, provider_package_id)
proceed, latest_change, changes = get_all_changes_for_package(
- provider_package_id, verbose, base_branch
+ provider_package_id, verbose, base_branch, force
)
provider_details = get_provider_details(provider_package_id)
provider_info = get_provider_info_from_provider_yaml(provider_package_id)
@@ -1329,9 +1337,25 @@ def update_release_notes(
)
jinja_context["DETAILED_CHANGES_RST"] = changes
jinja_context["DETAILED_CHANGES_PRESENT"] = len(changes) > 0
- update_commits_rst(
- jinja_context, provider_package_id, provider_details.documentation_provider_package_path
+ update_changelog_rst(
+ jinja_context,
+ provider_package_id,
+ provider_details.documentation_provider_package_path,
+ regenerate_missing_docs,
+ )
+ update_security_rst(
+ jinja_context,
+ provider_package_id,
+ provider_details.documentation_provider_package_path,
+ regenerate_missing_docs,
)
+ if not force:
+ update_commits_rst(
+ jinja_context,
+ provider_package_id,
+ provider_details.documentation_provider_package_path,
+ regenerate_missing_docs,
+ )
return True
@@ -1409,9 +1433,9 @@ AUTOMATICALLY_GENERATED_CONTENT = (
def update_index_rst(
- context,
- provider_package_id,
- target_path,
+ context: dict[str, Any],
+ provider_package_id: str,
+ target_path: Path,
):
index_update = render_template(
template_name="PROVIDER_INDEX", context=context, extension=".rst", keep_trailing_newline=True
@@ -1431,20 +1455,78 @@ def update_index_rst(
replace_content(index_file_path, old_text, new_text, provider_package_id)
-def update_commits_rst(
- context,
- provider_package_id,
- target_path,
+def _update_file(
+ context: dict[str, Any],
+ template_name: str,
+ extension: str,
+ file_name: str,
+ provider_package_id: str,
+ target_path: Path,
+ regenerate_missing_docs: bool,
):
+ file_path = target_path / file_name
+ if regenerate_missing_docs and file_path.exists():
+ return
new_text = render_template(
- template_name="PROVIDER_COMMITS", context=context, extension=".rst", keep_trailing_newline=True
+ template_name=template_name, context=context, extension=extension, keep_trailing_newline=True
)
- index_file_path = os.path.join(target_path, "commits.rst")
+ file_path = target_path / file_name
old_text = ""
- if os.path.isfile(index_file_path):
- with open(index_file_path) as readme_file_read:
+ if os.path.isfile(file_path):
+ with open(file_path) as readme_file_read:
old_text = readme_file_read.read()
- replace_content(index_file_path, old_text, new_text, provider_package_id)
+ replace_content(file_path, old_text, new_text, provider_package_id)
+
+
+def update_changelog_rst(
+ context: dict[str, Any],
+ provider_package_id: str,
+ target_path: Path,
+ regenerate_missing_docs: bool,
+):
+ _update_file(
+ context=context,
+ template_name="PROVIDER_CHANGELOG",
+ extension=".rst",
+ file_name="changelog.rst",
+ provider_package_id=provider_package_id,
+ target_path=target_path,
+ regenerate_missing_docs=regenerate_missing_docs,
+ )
+
+
+def update_security_rst(
+ context: dict[str, Any],
+ provider_package_id: str,
+ target_path: Path,
+ regenerate_missing_docs: bool,
+):
+ _update_file(
+ context=context,
+ template_name="PROVIDER_SECURITY",
+ extension=".rst",
+ file_name="security.rst",
+ provider_package_id=provider_package_id,
+ target_path=target_path,
+ regenerate_missing_docs=regenerate_missing_docs,
+ )
+
+
+def update_commits_rst(
+ context: dict[str, Any],
+ provider_package_id: str,
+ target_path: Path,
+ regenerate_missing_docs: bool,
+):
+ _update_file(
+ context=context,
+ template_name="PROVIDER_COMMITS",
+ extension=".rst",
+ file_name="commits.rst",
+ provider_package_id=provider_package_id,
+ target_path=target_path,
+ regenerate_missing_docs=regenerate_missing_docs,
+ )
def replace_min_airflow_version_in_provider_yaml(
@@ -1572,17 +1654,20 @@ def verify_changelog_exists(package: str) -> str:
provider_details = get_provider_details(package)
changelog_path = os.path.join(provider_details.source_provider_package_path, "CHANGELOG.rst")
if not os.path.isfile(changelog_path):
- console.print(f"[red]ERROR: Missing ${changelog_path}[/]")
- console.print("Please add the file with initial content:")
- console.print()
+ console.print(f"\n[red]ERROR: Missing {changelog_path}[/]\n")
+ console.print("[info]Please add the file with initial content:")
+ console.print("----- START COPYING AFTER THIS LINE ------- ")
+ processed_changelog = jinja2.Template(INITIAL_CHANGELOG_CONTENT, autoescape=True).render(
+ package_name=provider_details.pypi_package_name,
+ )
syntax = Syntax(
- INITIAL_CHANGELOG_CONTENT,
+ processed_changelog,
"rst",
theme="ansi_dark",
)
console.print(syntax)
- console.print()
- raise Exception(f"Missing {changelog_path}")
+ console.print("----- END COPYING BEFORE THIS LINE ------- ")
+ sys.exit(1)
return changelog_path
@@ -1631,14 +1716,16 @@ def update_package_documentation(
console.print("Updating documentation for the latest release version.")
make_sure_remote_apache_exists_and_fetch(git_update, verbose)
only_min_version_upgrade = os.environ.get("ONLY_MIN_VERSION_UPDATE", "false").lower() == "true"
+ regenerate_missing_docs = os.environ.get("REGENERATE_MISSING_DOCS", "false").lower() == "true"
if not only_min_version_upgrade:
if not update_release_notes(
provider_package_id,
version_suffix,
- force=force,
+ force=force or regenerate_missing_docs,
verbose=verbose,
answer=answer,
base_branch=base_branch,
+ regenerate_missing_docs=regenerate_missing_docs,
):
# Returns 64 in case of skipped package
sys.exit(64)
@@ -1853,11 +1940,11 @@ def get_changes_classified(changes: list[Change]) -> ClassifiedChanges:
@option_verbose
def update_changelog(package_id: str, base_branch: str, verbose: bool):
"""Updates changelog for the provider."""
- if _update_changelog(package_id, base_branch, verbose):
+ if _update_changelog(package_id, base_branch, verbose, True):
sys.exit(64)
-def _update_changelog(package_id: str, base_branch: str, verbose: bool) -> bool:
+def _update_changelog(package_id: str, base_branch: str, verbose: bool, force: bool) -> bool:
"""Internal update changelog method.
:param package_id: package id
@@ -1877,13 +1964,22 @@ def _update_changelog(package_id: str, base_branch: str, verbose: bool) -> bool:
version_suffix="",
)
changelog_path = os.path.join(provider_details.source_provider_package_path, "CHANGELOG.rst")
- proceed, changes, _ = get_all_changes_for_package(package_id, verbose, base_branch)
+ proceed, changes, _ = get_all_changes_for_package(package_id, verbose, base_branch, force)
if not proceed:
- console.print(
- f"[yellow]The provider {package_id} is not being released. Skipping the package.[/]"
- )
+ if force:
+ console.print(
+ f"[info]The provider {package_id} is not being release but we regenerate docs for it "
+ f"(except commits).[/]"
+ )
+ else:
+ console.print(
+ f"[yellow]The provider {package_id} is not being released. Skipping the package.[/]"
+ )
return True
- generate_new_changelog(package_id, provider_details, changelog_path, changes)
+ if os.environ.get("REGENERATE_MISSING_DOCS", "false").lower() == "true":
+ console.print("[info]REGENERATE_MISSING_DOCS is set to true, skipping changelog update[/]")
+ else:
+ generate_new_changelog(package_id, provider_details, changelog_path, changes)
console.print()
console.print(f"Update index.rst for {package_id}")
console.print()
@@ -1969,7 +2065,7 @@ def update_changelogs(changelog_files: list[str], git_update: bool, base_branch:
make_sure_remote_apache_exists_and_fetch(git_update, verbose)
for changelog_file in changelog_files:
package_id = get_package_from_changelog(changelog_file)
- _update_changelog(package_id=package_id, base_branch=base_branch, verbose=verbose)
+ _update_changelog(package_id=package_id, base_branch=base_branch, verbose=verbose, force=True)
if __name__ == "__main__":
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-airbyte/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-airbyte/changelog.rst
index 450e8ed420..df72f14d05 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-airbyte/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-airbyte``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/airbyte/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-airbyte/index.rst b/docs/apache-airflow-providers-airbyte/index.rst
index bd27d6cc75..0d4e5d99fc 100644
--- a/docs/apache-airflow-providers-airbyte/index.rst
+++ b/docs/apache-airflow-providers-airbyte/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-airbyte``
====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -29,6 +37,7 @@ Content
Connection types <connections>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/airbyte/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -118,5 +130,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-airbyte 3.3.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-airbyte-3.3.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-airbyte-3.3.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-airbyte-3.3.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-airbyte 3.3.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_airbyte-3.3.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_airbyte-3.3.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_airbyte-3.3.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/airbyte/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-airbyte/security.rst b/docs/apache-airflow-providers-airbyte/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-airbyte/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-alibaba/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-alibaba/changelog.rst
index 450e8ed420..c032cb7d6a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-alibaba/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-alibaba``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/alibaba/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-alibaba/index.rst b/docs/apache-airflow-providers-alibaba/index.rst
index c050e7e9da..2b468623ff 100644
--- a/docs/apache-airflow-providers-alibaba/index.rst
+++ b/docs/apache-airflow-providers-alibaba/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-alibaba``
====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Logging for Tasks <logging/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/alibaba/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -93,5 +105,3 @@ PIP package Version required
``alibabacloud_adb20211201`` ``>=1.0.0``
``alibabacloud_tea_openapi`` ``>=0.3.7``
============================ ==================
-
-.. include:: ../../airflow/providers/alibaba/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-alibaba/security.rst b/docs/apache-airflow-providers-alibaba/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-alibaba/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-amazon/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-amazon/changelog.rst
index 450e8ed420..aed399da66 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-amazon/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-amazon``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/amazon/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-amazon/index.rst b/docs/apache-airflow-providers-amazon/index.rst
index e0b148425c..e4fd28da4a 100644
--- a/docs/apache-airflow-providers-amazon/index.rst
+++ b/docs/apache-airflow-providers-amazon/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-amazon``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -33,24 +41,22 @@ Content
Logging for Tasks <logging/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/amazon/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: System tests
+ System Tests <_api/tests/system/providers/amazon/index>
System Tests Dashboard <https://aws-mwaa.github.io/open-source/system-tests/dashboard.html>
.. toctree::
:hidden:
- :caption: System tests
-
- System Tests <_api/tests/system/providers/amazon/index>
-
-.. toctree::
:maxdepth: 1
:caption: Resources
@@ -62,6 +68,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -149,5 +156,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-amazon 8.2.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-amazon-8.2.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-amazon-8.2.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-amazon-8.2.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-amazon 8.2.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_amazon-8.2.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_amazon-8.2.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_amazon-8.2.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/amazon/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-amazon/security.rst b/docs/apache-airflow-providers-amazon/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-amazon/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-beam/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-beam/changelog.rst
index 450e8ed420..f8bf09df1c 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-beam/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-beam``
+------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/beam/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-beam/index.rst b/docs/apache-airflow-providers-apache-beam/index.rst
index 30ceaf0868..3ca1179cae 100644
--- a/docs/apache-airflow-providers-apache-beam/index.rst
+++ b/docs/apache-airflow-providers-apache-beam/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-apache-beam``
========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -29,11 +37,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/beam/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -41,6 +51,7 @@ Content
Example DAGs <https://github.com/apache/airflow/tree/providers-apache-beam/|version|/tests/system/providers/apache/beam>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -51,6 +62,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -117,5 +129,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-beam 5.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-beam-5.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-beam-5.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-beam-5.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-beam 5.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_beam-5.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_beam-5.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_beam-5.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/beam/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-beam/security.rst b/docs/apache-airflow-providers-apache-beam/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-beam/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-cassandra/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-cassandra/changelog.rst
index 450e8ed420..ff78c1158e 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-cassandra/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-cassandra``
+-----------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/cassandra/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-cassandra/index.rst b/docs/apache-airflow-providers-apache-cassandra/index.rst
index d33605c9fc..81e6cc6aa8 100644
--- a/docs/apache-airflow-providers-apache-cassandra/index.rst
+++ b/docs/apache-airflow-providers-apache-cassandra/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-apache-cassandra``
=============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -29,6 +37,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/cassandra/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``cassandra-driver`` ``>=3.13.0``
==================== ==================
-
-.. include:: ../../airflow/providers/apache/cassandra/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-cassandra/security.rst b/docs/apache-airflow-providers-apache-cassandra/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-cassandra/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-drill/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-drill/changelog.rst
index 450e8ed420..d1cdd2f304 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-drill/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-drill``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/drill/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-drill/index.rst b/docs/apache-airflow-providers-apache-drill/index.rst
index 461f5c009e..c36ef96f89 100644
--- a/docs/apache-airflow-providers-apache-drill/index.rst
+++ b/docs/apache-airflow-providers-apache-drill/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-apache-drill``
=========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -29,6 +37,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/drill/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-drill 2.4.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-drill-2.4.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-drill-2.4.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-drill-2.4.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-drill 2.4.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_drill-2.4.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_drill-2.4.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_drill-2.4.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/drill/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-drill/security.rst b/docs/apache-airflow-providers-apache-drill/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-drill/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-druid/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-druid/changelog.rst
index 450e8ed420..a77d36598a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-druid/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-druid``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/druid/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-druid/index.rst b/docs/apache-airflow-providers-apache-druid/index.rst
index 967203ca63..5c5771d702 100644
--- a/docs/apache-airflow-providers-apache-druid/index.rst
+++ b/docs/apache-airflow-providers-apache-druid/index.rst
@@ -18,16 +18,25 @@
``apache-airflow-providers-apache-druid``
=========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -35,12 +44,14 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/druid/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-druid 3.4.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-druid-3.4.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-druid-3.4.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-druid-3.4.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-druid 3.4.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_druid-3.4.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_druid-3.4.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_druid-3.4.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/druid/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-druid/security.rst b/docs/apache-airflow-providers-apache-druid/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-druid/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-flink/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-flink/changelog.rst
index 450e8ed420..5738f55e53 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-flink/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-flink``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/flink/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-flink/index.rst b/docs/apache-airflow-providers-apache-flink/index.rst
index cb5958b778..0a50ed7491 100644
--- a/docs/apache-airflow-providers-apache-flink/index.rst
+++ b/docs/apache-airflow-providers-apache-flink/index.rst
@@ -18,22 +18,32 @@
``apache-airflow-providers-apache-flink``
=========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/apache/flink/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -45,6 +55,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -112,5 +123,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-flink 1.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-flink-1.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-flink-1.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-flink-1.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-flink 1.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_flink-1.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_flink-1.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_flink-1.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/flink/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-flink/security.rst b/docs/apache-airflow-providers-apache-flink/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-flink/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-hdfs/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-hdfs/changelog.rst
index 450e8ed420..85395a91c9 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-hdfs/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-hdfs``
+------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/hdfs/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-hdfs/index.rst b/docs/apache-airflow-providers-apache-hdfs/index.rst
index 00c9dba631..6178e9c5d7 100644
--- a/docs/apache-airflow-providers-apache-hdfs/index.rst
+++ b/docs/apache-airflow-providers-apache-hdfs/index.rst
@@ -19,10 +19,18 @@
========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -31,6 +39,7 @@ Content
Logging for Tasks <logging/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -42,6 +51,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -81,5 +91,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``hdfs[avro,dataframe,kerberos]`` ``>=2.0.4``
================================= ==================
-
-.. include:: ../../airflow/providers/apache/hdfs/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-hdfs/security.rst b/docs/apache-airflow-providers-apache-hdfs/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-hdfs/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-hive/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-hive/changelog.rst
index 450e8ed420..d93dba54e3 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-hive/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-hive``
+------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/hive/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-hive/index.rst b/docs/apache-airflow-providers-apache-hive/index.rst
index da4d4e397d..76ea9a6f4e 100644
--- a/docs/apache-airflow-providers-apache-hive/index.rst
+++ b/docs/apache-airflow-providers-apache-hive/index.rst
@@ -19,10 +19,18 @@
========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/hive/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -54,6 +65,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -131,5 +143,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-hive 6.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-hive-6.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-hive-6.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-hive-6.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-hive 6.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_hive-6.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_hive-6.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_hive-6.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/hive/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-hive/security.rst b/docs/apache-airflow-providers-apache-hive/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-hive/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-impala/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-impala/changelog.rst
index 450e8ed420..5f504622be 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-impala/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-impala``
+--------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/impala/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-impala/index.rst b/docs/apache-airflow-providers-apache-impala/index.rst
index 516043d5a5..c9a6b364dd 100644
--- a/docs/apache-airflow-providers-apache-impala/index.rst
+++ b/docs/apache-airflow-providers-apache-impala/index.rst
@@ -19,22 +19,32 @@
==========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Connection Types <connections/impala>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API<_api/airflow/providers/apache/impala/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -42,6 +52,7 @@ Content
Installing from sources <installing-providers-from-sources>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -51,6 +62,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -117,5 +129,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-impala 1.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-impala-1.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-impala-1.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-impala-1.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-impala 1.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_impala-1.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_impala-1.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_impala-1.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/impala/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-impala/security.rst b/docs/apache-airflow-providers-apache-impala/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-impala/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-kafka/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-kafka/changelog.rst
index 450e8ed420..b2b294b36c 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-kafka/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-kafka``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/kafka/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-kafka/index.rst b/docs/apache-airflow-providers-apache-kafka/index.rst
index 278a3accb2..2c56ce0046 100644
--- a/docs/apache-airflow-providers-apache-kafka/index.rst
+++ b/docs/apache-airflow-providers-apache-kafka/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-apache-kafka``
==========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -34,6 +42,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -41,12 +50,14 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/kafka/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -58,6 +69,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -97,5 +109,3 @@ PIP package Version required
``asgiref``
``confluent-kafka`` ``>=1.8.2``
=================== ==================
-
-.. include:: ../../airflow/providers/apache/kafka/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-kafka/security.rst b/docs/apache-airflow-providers-apache-kafka/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-kafka/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-kylin/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-kylin/changelog.rst
index 450e8ed420..30e11d3bde 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-kylin/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-kylin``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/kylin/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-kylin/index.rst b/docs/apache-airflow-providers-apache-kylin/index.rst
index 6312c91ebd..faac30969b 100644
--- a/docs/apache-airflow-providers-apache-kylin/index.rst
+++ b/docs/apache-airflow-providers-apache-kylin/index.rst
@@ -19,10 +19,18 @@
=========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -30,11 +38,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/kylin/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -46,6 +56,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -84,5 +95,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``kylinpy`` ``>=2.6``
================== ==================
-
-.. include:: ../../airflow/providers/apache/kylin/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-kylin/security.rst b/docs/apache-airflow-providers-apache-kylin/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-kylin/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-livy/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-livy/changelog.rst
index 450e8ed420..1e0af37c44 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-livy/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-livy``
+------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/livy/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-livy/index.rst b/docs/apache-airflow-providers-apache-livy/index.rst
index fcfd569ad0..4db63c3ae9 100644
--- a/docs/apache-airflow-providers-apache-livy/index.rst
+++ b/docs/apache-airflow-providers-apache-livy/index.rst
@@ -18,16 +18,25 @@
``apache-airflow-providers-apache-livy``
========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -35,11 +44,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/livy/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -51,6 +62,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-livy 3.5.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-livy-3.5.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-livy-3.5.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-livy-3.5.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-livy 3.5.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_livy-3.5.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_livy-3.5.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_livy-3.5.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/livy/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-livy/security.rst b/docs/apache-airflow-providers-apache-livy/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-livy/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-pig/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-pig/changelog.rst
index 450e8ed420..355f67835b 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-pig/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-pig``
+-----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/pig/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-pig/index.rst b/docs/apache-airflow-providers-apache-pig/index.rst
index 554c54ac1d..19e6b16613 100644
--- a/docs/apache-airflow-providers-apache-pig/index.rst
+++ b/docs/apache-airflow-providers-apache-pig/index.rst
@@ -18,16 +18,25 @@
``apache-airflow-providers-apache-pig``
=======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -35,11 +44,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/pig/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -51,6 +62,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -88,5 +100,3 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
-
-.. include:: ../../airflow/providers/apache/pig/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-pig/security.rst b/docs/apache-airflow-providers-apache-pig/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-pig/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-pinot/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-pinot/changelog.rst
index 450e8ed420..4e510c766e 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-pinot/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-pinot``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/pinot/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-pinot/index.rst b/docs/apache-airflow-providers-apache-pinot/index.rst
index b0f9b2c3aa..83c7899d56 100644
--- a/docs/apache-airflow-providers-apache-pinot/index.rst
+++ b/docs/apache-airflow-providers-apache-pinot/index.rst
@@ -18,15 +18,25 @@
``apache-airflow-providers-apache-pinot``
=========================================
-Content
--------
+
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,6 +47,7 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/pinot/index>
@@ -45,6 +56,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -112,5 +124,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-apache-pinot 4.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-pinot-4.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-pinot-4.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-apache-pinot-4.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-apache-pinot 4.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_pinot-4.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_pinot-4.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_apache_pinot-4.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/apache/pinot/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-pinot/security.rst b/docs/apache-airflow-providers-apache-pinot/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-pinot/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-spark/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-spark/changelog.rst
index 450e8ed420..9817d19502 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-spark/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-spark``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/spark/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-spark/index.rst b/docs/apache-airflow-providers-apache-spark/index.rst
index da58352a8f..1bd8a1def9 100644
--- a/docs/apache-airflow-providers-apache-spark/index.rst
+++ b/docs/apache-airflow-providers-apache-spark/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-apache-spark``
=========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -29,6 +37,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/apache/spark/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``pyspark``
================== ==================
-
-.. include:: ../../airflow/providers/apache/spark/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-spark/security.rst b/docs/apache-airflow-providers-apache-spark/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-spark/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apache-sqoop/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apache-sqoop/changelog.rst
index 450e8ed420..b17af28da0 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apache-sqoop/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apache-sqoop``
+-------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apache/sqoop/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-sqoop/index.rst b/docs/apache-airflow-providers-apache-sqoop/index.rst
index 0d627bf7c1..b855d24edc 100644
--- a/docs/apache-airflow-providers-apache-sqoop/index.rst
+++ b/docs/apache-airflow-providers-apache-sqoop/index.rst
@@ -18,9 +18,18 @@
``apache-airflow-providers-apache-sqoop``
=========================================
-Content
--------
+
+.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -28,6 +37,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -39,6 +49,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -76,5 +87,3 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
-
-.. include:: ../../airflow/providers/apache/sqoop/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apache-sqoop/security.rst b/docs/apache-airflow-providers-apache-sqoop/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apache-sqoop/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-apprise/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-apprise/changelog.rst
index 450e8ed420..3dc9d66f9f 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-apprise/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-apprise``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/apprise/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-apprise/index.rst b/docs/apache-airflow-providers-apprise/index.rst
index 36cec302cb..36e314095b 100644
--- a/docs/apache-airflow-providers-apprise/index.rst
+++ b/docs/apache-airflow-providers-apprise/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-apprise``
======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -37,6 +46,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -71,3 +81,47 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
+
+.. THE REMAINDER OF THE FILE IS AUTOMATICALLY GENERATED. IT WILL BE OVERWRITTEN AT RELEASE TIME!
+
+
+.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Commits
+
+ Detailed list of commits <commits>
+
+
+Package apache-airflow-providers-apprise
+------------------------------------------------------
+
+`Apprise <https://github.com/caronc/apprise>`__
+
+
+Release: 1.0.0
+
+Provider package
+----------------
+
+This is a provider package for ``apprise`` provider. All classes for this provider package
+are in ``airflow.providers.apprise`` python package.
+
+Installation
+------------
+
+You can install this package on top of an existing Airflow 2 installation (see ``Requirements`` below)
+for the minimum Airflow version supported) via
+``pip install apache-airflow-providers-apprise``
+
+Requirements
+------------
+
+The minimum Apache Airflow version supported by this provider package is ``2.4.0``.
+
+================== ==================
+PIP package Version required
+================== ==================
+``apache-airflow`` ``>=2.4.0``
+``apprise``
+================== ==================
diff --git a/docs/apache-airflow-providers-apprise/security.rst b/docs/apache-airflow-providers-apprise/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-apprise/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-arangodb/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-arangodb/changelog.rst
index 450e8ed420..53d58b0623 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-arangodb/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-arangodb``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/arangodb/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-arangodb/index.rst b/docs/apache-airflow-providers-arangodb/index.rst
index 2e926f8746..6a515c9d95 100644
--- a/docs/apache-airflow-providers-arangodb/index.rst
+++ b/docs/apache-airflow-providers-arangodb/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-arangodb``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,18 +38,21 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/arangodb/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
Example DAGs <https://github.com/apache/airflow/tree/providers-arangodb/|version|/airflow/providers/arangodb/example_dags>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``python-arango`` ``>=7.3.2``
================== ==================
-
-.. include:: ../../airflow/providers/arangodb/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-arangodb/security.rst b/docs/apache-airflow-providers-arangodb/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-arangodb/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-asana/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-asana/changelog.rst
index 450e8ed420..f27de03b77 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-asana/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-asana``
+------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/asana/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-asana/index.rst b/docs/apache-airflow-providers-asana/index.rst
index 447e19066d..8c901f39c2 100644
--- a/docs/apache-airflow-providers-asana/index.rst
+++ b/docs/apache-airflow-providers-asana/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-asana``
==================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/asana/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -91,5 +103,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``asana`` ``>=0.10``
================== ==================
-
-.. include:: ../../airflow/providers/asana/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-asana/security.rst b/docs/apache-airflow-providers-asana/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-asana/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-atlassian-jira/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-atlassian-jira/changelog.rst
index 450e8ed420..f5b77baa5d 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-atlassian-jira/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-atlassian-jira``
+---------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/atlassian/jira/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-atlassian-jira/index.rst b/docs/apache-airflow-providers-atlassian-jira/index.rst
index 9f73c3bd83..62d9eff161 100644
--- a/docs/apache-airflow-providers-atlassian-jira/index.rst
+++ b/docs/apache-airflow-providers-atlassian-jira/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-atlassian-jira``
===========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/atlassian/jira/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -39,6 +48,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -77,5 +87,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``atlassian-python-api`` ``>=1.14.2``
======================== ==================
-
-.. include:: ../../airflow/providers/atlassian/jira/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-atlassian-jira/security.rst b/docs/apache-airflow-providers-atlassian-jira/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-atlassian-jira/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-celery/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-celery/changelog.rst
index 450e8ed420..3a3395be98 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-celery/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-celery``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/celery/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-celery/index.rst b/docs/apache-airflow-providers-celery/index.rst
index 1bc1a5f7e0..fbf57bead9 100644
--- a/docs/apache-airflow-providers-celery/index.rst
+++ b/docs/apache-airflow-providers-celery/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-celery``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -34,6 +42,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -73,5 +82,3 @@ PIP package Version required
``celery`` ``>=5.2.3,<6``
``flower`` ``>=1.0.0``
================== ==================
-
-.. include:: ../../airflow/providers/celery/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-celery/security.rst b/docs/apache-airflow-providers-celery/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-celery/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-cloudant/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-cloudant/changelog.rst
index 450e8ed420..d92c198cfc 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-cloudant/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-cloudant``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/cloudant/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-cloudant/index.rst b/docs/apache-airflow-providers-cloudant/index.rst
index 067ab2e6c3..143626b780 100644
--- a/docs/apache-airflow-providers-cloudant/index.rst
+++ b/docs/apache-airflow-providers-cloudant/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-cloudant``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -34,6 +42,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -72,5 +81,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``cloudant`` ``>=2.0``
================== ==================
-
-.. include:: ../../airflow/providers/cloudant/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-cloudant/security.rst b/docs/apache-airflow-providers-cloudant/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-cloudant/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-cncf-kubernetes/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-cncf-kubernetes/changelog.rst
index 450e8ed420..284f102488 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-cncf-kubernetes/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-cncf-kubernetes``
+----------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/cncf/kubernetes/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-cncf-kubernetes/index.rst b/docs/apache-airflow-providers-cncf-kubernetes/index.rst
index 5947fd9a74..f511ea5ecb 100644
--- a/docs/apache-airflow-providers-cncf-kubernetes/index.rst
+++ b/docs/apache-airflow-providers-cncf-kubernetes/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-cncf-kubernetes``
============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/cncf/kubernetes/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -94,5 +106,3 @@ PIP package Version required
``kubernetes`` ``>=21.7.0,<24``
``kubernetes_asyncio`` ``>=18.20.1,<25``
====================== ==================
-
-.. include:: ../../airflow/providers/cncf/kubernetes/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-cncf-kubernetes/security.rst b/docs/apache-airflow-providers-cncf-kubernetes/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-cncf-kubernetes/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-common-sql/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-common-sql/changelog.rst
index 450e8ed420..2b8d6ae7e8 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-common-sql/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-common-sql``
+-----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/common/sql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-common-sql/index.rst b/docs/apache-airflow-providers-common-sql/index.rst
index afcc24d0f9..027c9a436d 100644
--- a/docs/apache-airflow-providers-common-sql/index.rst
+++ b/docs/apache-airflow-providers-common-sql/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-common-sql``
=======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -29,6 +37,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/common/sql/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``sqlparse`` ``>=0.4.2``
================== ==================
-
-.. include:: ../../airflow/providers/common/sql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-common-sql/security.rst b/docs/apache-airflow-providers-common-sql/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-common-sql/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-databricks/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-databricks/changelog.rst
index 450e8ed420..9a262c2567 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-databricks/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-databricks``
+-----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/databricks/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-databricks/index.rst b/docs/apache-airflow-providers-databricks/index.rst
index a3d96eef7c..c04b6d656c 100644
--- a/docs/apache-airflow-providers-databricks/index.rst
+++ b/docs/apache-airflow-providers-databricks/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-databricks``
============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/databricks/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -122,5 +134,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-databricks 4.3.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-databricks-4.3.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-databricks-4.3.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-databricks-4.3.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-databricks 4.3.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_databricks-4.3.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_databricks-4.3.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_databricks-4.3.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/databricks/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-databricks/security.rst b/docs/apache-airflow-providers-databricks/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-databricks/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-datadog/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-datadog/changelog.rst
index 450e8ed420..99ff68850f 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-datadog/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-datadog``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/datadog/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-datadog/index.rst b/docs/apache-airflow-providers-datadog/index.rst
index 74af7c7531..f3f2c77302 100644
--- a/docs/apache-airflow-providers-datadog/index.rst
+++ b/docs/apache-airflow-providers-datadog/index.rst
@@ -19,22 +19,32 @@
``apache-airflow-providers-datadog``
====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Connection types <connections/datadog>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/datadog/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -45,6 +55,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -83,5 +94,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``datadog`` ``>=0.14.0``
================== ==================
-
-.. include:: ../../airflow/providers/datadog/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-datadog/security.rst b/docs/apache-airflow-providers-datadog/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-datadog/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-dbt-cloud/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-dbt-cloud/changelog.rst
index 450e8ed420..7d262eb397 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-dbt-cloud/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-dbt-cloud``
+----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/dbt/cloud/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-dbt-cloud/index.rst b/docs/apache-airflow-providers-dbt-cloud/index.rst
index b5052373a9..0fe39d64a8 100644
--- a/docs/apache-airflow-providers-dbt-cloud/index.rst
+++ b/docs/apache-airflow-providers-dbt-cloud/index.rst
@@ -23,10 +23,18 @@ equipped with turnkey support for scheduling jobs, CI/CD, serving documentation,
an Integrated Developer Environment (IDE).
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -34,6 +42,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -41,11 +50,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/dbt/cloud/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -57,6 +68,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -125,5 +137,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-dbt-cloud 3.2.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dbt-cloud-3.2.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dbt-cloud-3.2.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dbt-cloud-3.2.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-dbt-cloud 3.2.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dbt_cloud-3.2.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dbt_cloud-3.2.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dbt_cloud-3.2.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/dbt/cloud/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-dbt-cloud/security.rst b/docs/apache-airflow-providers-dbt-cloud/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-dbt-cloud/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-dingding/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-dingding/changelog.rst
index 450e8ed420..272bd9d017 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-dingding/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-dingding``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/dingding/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-dingding/index.rst b/docs/apache-airflow-providers-dingding/index.rst
index eaaca2e854..21991617b3 100644
--- a/docs/apache-airflow-providers-dingding/index.rst
+++ b/docs/apache-airflow-providers-dingding/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-dingding``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/dingding/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -118,5 +130,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-dingding 3.2.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dingding-3.2.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dingding-3.2.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-dingding-3.2.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-dingding 3.2.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dingding-3.2.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dingding-3.2.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_dingding-3.2.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/dingding/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-dingding/security.rst b/docs/apache-airflow-providers-dingding/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-dingding/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-discord/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-discord/changelog.rst
index 450e8ed420..d26072461d 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-discord/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-discord``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/discord/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-discord/index.rst b/docs/apache-airflow-providers-discord/index.rst
index 81f0753b18..746732257f 100644
--- a/docs/apache-airflow-providers-discord/index.rst
+++ b/docs/apache-airflow-providers-discord/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-discord``
====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -34,6 +42,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -100,5 +109,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-discord 3.3.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-discord-3.3.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-discord-3.3.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-discord-3.3.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-discord 3.3.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_discord-3.3.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_discord-3.3.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_discord-3.3.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/discord/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-discord/security.rst b/docs/apache-airflow-providers-discord/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-discord/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-docker/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-docker/changelog.rst
index 450e8ed420..d92635e586 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-docker/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-docker``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/docker/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-docker/index.rst b/docs/apache-airflow-providers-docker/index.rst
index d306f55479..6ba54a0eb2 100644
--- a/docs/apache-airflow-providers-docker/index.rst
+++ b/docs/apache-airflow-providers-docker/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-docker``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -31,11 +39,13 @@ Content
Docker Task Decorator <decorators/docker>
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/docker/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -47,6 +57,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -86,5 +97,3 @@ PIP package Version required
``docker`` ``>=5.0.3``
``python-dotenv`` ``>=0.21.0``
================== ==================
-
-.. include:: ../../airflow/providers/docker/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-docker/security.rst b/docs/apache-airflow-providers-docker/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-docker/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-elasticsearch/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-elasticsearch/changelog.rst
index 450e8ed420..287030242d 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-elasticsearch/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-elasticsearch``
+--------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/elasticsearch/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-elasticsearch/index.rst b/docs/apache-airflow-providers-elasticsearch/index.rst
index 9d9f0b24cb..5a4582412a 100644
--- a/docs/apache-airflow-providers-elasticsearch/index.rst
+++ b/docs/apache-airflow-providers-elasticsearch/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-elasticsearch``
==========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -31,6 +39,7 @@ Content
Elasticsearch hooks <hooks/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -38,11 +47,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/elasticsearch/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -54,6 +65,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -66,7 +78,7 @@ Package apache-airflow-providers-elasticsearch
`Elasticsearch <https://www.elastic.co/elasticsearch>`__
-Release: 4.5.1
+Release: 5.0.0
Provider package
----------------
@@ -119,7 +131,5 @@ Downloading official packages
You can download officially released packages and verify their checksums and signatures from the
`Official Apache Download site <https://downloads.apache.org/airflow/providers/>`_
-* `The apache-airflow-providers-elasticsearch 4.5.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-4.5.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-4.5.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-4.5.1.tar.gz.sha512>`__)
-* `The apache-airflow-providers-elasticsearch 4.5.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-4.5.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-4.5.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-4.5.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/elasticsearch/CHANGELOG.rst
+* `The apache-airflow-providers-elasticsearch 5.0.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-5.0.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-5.0.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-elasticsearch-5.0.0.tar.gz.sha512>`__)
+* `The apache-airflow-providers-elasticsearch 5.0.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-5.0.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-5.0.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_elasticsearch-5.0.0-py3-none-any.whl.sha512>`__)
diff --git a/docs/apache-airflow-providers-elasticsearch/security.rst b/docs/apache-airflow-providers-elasticsearch/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-elasticsearch/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-exasol/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-exasol/changelog.rst
index 450e8ed420..4dc893b566 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-exasol/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-exasol``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/exasol/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-exasol/index.rst b/docs/apache-airflow-providers-exasol/index.rst
index e04c31a3a1..30821732af 100644
--- a/docs/apache-airflow-providers-exasol/index.rst
+++ b/docs/apache-airflow-providers-exasol/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-exasol``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/exasol/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -39,6 +48,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -107,5 +117,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-exasol 4.2.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-exasol-4.2.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-exasol-4.2.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-exasol-4.2.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-exasol 4.2.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_exasol-4.2.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_exasol-4.2.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_exasol-4.2.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/exasol/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-exasol/security.rst b/docs/apache-airflow-providers-exasol/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-exasol/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-facebook/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-facebook/changelog.rst
index 450e8ed420..d58f217b64 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-facebook/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-facebook``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/facebook/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-facebook/index.rst b/docs/apache-airflow-providers-facebook/index.rst
index 395370256d..6baf2d11d8 100644
--- a/docs/apache-airflow-providers-facebook/index.rst
+++ b/docs/apache-airflow-providers-facebook/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-facebook``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/facebook/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -39,6 +48,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -77,5 +87,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``facebook-business`` ``>=6.0.2``
===================== ==================
-
-.. include:: ../../airflow/providers/facebook/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-facebook/security.rst b/docs/apache-airflow-providers-facebook/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-facebook/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-ftp/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-ftp/changelog.rst
index 450e8ed420..6b7a72cefb 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-ftp/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-ftp``
+----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/ftp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-ftp/index.rst b/docs/apache-airflow-providers-ftp/index.rst
index e027aabb15..bc490af326 100644
--- a/docs/apache-airflow-providers-ftp/index.rst
+++ b/docs/apache-airflow-providers-ftp/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-ftp``
================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -30,6 +38,7 @@ Content
Python API <_api/airflow/providers/ftp/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Operators
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/ftp/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -51,6 +62,7 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/ftp/index>
@@ -59,6 +71,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -96,5 +109,3 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
-
-.. include:: ../../airflow/providers/ftp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-ftp/security.rst b/docs/apache-airflow-providers-ftp/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-ftp/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-github/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-github/changelog.rst
index 450e8ed420..964dfec0fd 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-github/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-github``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/github/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-github/index.rst b/docs/apache-airflow-providers-github/index.rst
index 83c2445b9d..ad58032c3b 100644
--- a/docs/apache-airflow-providers-github/index.rst
+++ b/docs/apache-airflow-providers-github/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-github``
=======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/github/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -50,6 +61,7 @@ Content
Installing from sources <installing-providers-from-sources>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -59,6 +71,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -97,5 +110,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``PyGithub!`` ``=1.58``
================== ==================
-
-.. include:: ../../airflow/providers/github/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-github/security.rst b/docs/apache-airflow-providers-github/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-github/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-google/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-google/changelog.rst
index 450e8ed420..abda3f330d 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-google/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-google``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/google/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-google/index.rst b/docs/apache-airflow-providers-google/index.rst
index a77877b7ed..5e322f9d00 100644
--- a/docs/apache-airflow-providers-google/index.rst
+++ b/docs/apache-airflow-providers-google/index.rst
@@ -18,10 +18,18 @@
``apache-airflow-providers-google``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -33,6 +41,7 @@ Content
Sensors <sensors/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -41,11 +50,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/google/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -57,6 +68,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -105,7 +117,7 @@ PIP package Version required
``gcloud-aio-auth`` ``>=4.0.0,<5.0.0``
``gcloud-aio-bigquery`` ``>=6.1.2``
``gcloud-aio-storage``
-``google-ads`` ``>=20.0.0``
+``google-ads`` ``>=21.2.0``
``google-api-core`` ``>=2.11.0``
``google-api-python-client`` ``>=1.6.0``
``google-auth`` ``>=1.0.0``
@@ -196,5 +208,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-google 10.2.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-google-10.2.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-google-10.2.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-google-10.2.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-google 10.2.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_google-10.2.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_google-10.2.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_google-10.2.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/google/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-google/security.rst b/docs/apache-airflow-providers-google/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-google/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-grpc/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-grpc/changelog.rst
index 450e8ed420..051d23b8a8 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-grpc/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-grpc``
+-----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/grpc/CHANGELOG.rst
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-grpc/connections/index.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-grpc/connections/index.rst
index 450e8ed420..2b8afb41df 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-grpc/connections/index.rst
@@ -15,8 +15,11 @@
specific language governing permissions and limitations
under the License.
+Connection Types
+----------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. toctree::
+ :maxdepth: 1
+ :glob:
+
+ *
diff --git a/docs/apache-airflow-providers-grpc/index.rst b/docs/apache-airflow-providers-grpc/index.rst
index 31f6e59924..4180c382a6 100644
--- a/docs/apache-airflow-providers-grpc/index.rst
+++ b/docs/apache-airflow-providers-grpc/index.rst
@@ -19,22 +19,32 @@
``apache-airflow-providers-grpc``
=================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
- Connection types <connections/grpc>
+ Connection types <connections/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/grpc/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -45,6 +55,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -85,5 +96,3 @@ PIP package Version required
``google-auth-httplib2`` ``>=0.0.1``
``grpcio`` ``>=1.15.0``
======================== ===================
-
-.. include:: ../../airflow/providers/grpc/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-grpc/security.rst b/docs/apache-airflow-providers-grpc/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-grpc/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-hashicorp/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-hashicorp/changelog.rst
index 450e8ed420..7ba4a83c0a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-hashicorp/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-hashicorp``
+----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/hashicorp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-hashicorp/index.rst b/docs/apache-airflow-providers-hashicorp/index.rst
index df6c3725df..a1b4007398 100644
--- a/docs/apache-airflow-providers-hashicorp/index.rst
+++ b/docs/apache-airflow-providers-hashicorp/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-hashicorp``
======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,12 +38,14 @@ Content
Secrets backends <secrets-backends/hashicorp-vault>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/hashicorp/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -46,6 +56,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -112,5 +123,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-hashicorp 3.4.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-hashicorp-3.4.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-hashicorp-3.4.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-hashicorp-3.4.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-hashicorp 3.4.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_hashicorp-3.4.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_hashicorp-3.4.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_hashicorp-3.4.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/hashicorp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-hashicorp/security.rst b/docs/apache-airflow-providers-hashicorp/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-hashicorp/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-http/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-http/changelog.rst
index 450e8ed420..30efed25e3 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-http/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-http``
+-----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/http/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-http/index.rst b/docs/apache-airflow-providers-http/index.rst
index 48c5d42f39..70d28ec4d6 100644
--- a/docs/apache-airflow-providers-http/index.rst
+++ b/docs/apache-airflow-providers-http/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-http``
=================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/http/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -94,5 +106,3 @@ PIP package Version required
``aiohttp``
``asgiref``
===================== ==================
-
-.. include:: ../../airflow/providers/http/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-http/security.rst b/docs/apache-airflow-providers-http/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-http/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-imap/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-imap/changelog.rst
index 450e8ed420..b635271658 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-imap/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-imap``
+-----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/imap/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-imap/index.rst b/docs/apache-airflow-providers-imap/index.rst
index dba38f5fd2..ef8e28b9e0 100644
--- a/docs/apache-airflow-providers-imap/index.rst
+++ b/docs/apache-airflow-providers-imap/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-imap``
=================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -30,6 +38,7 @@ Content
Python API <_api/airflow/providers/imap/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -40,6 +49,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -77,5 +87,3 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
-
-.. include:: ../../airflow/providers/imap/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-imap/security.rst b/docs/apache-airflow-providers-imap/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-imap/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-influxdb/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-influxdb/changelog.rst
index 450e8ed420..2c32bdae5a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-influxdb/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-influxdb``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/influxdb/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-influxdb/index.rst b/docs/apache-airflow-providers-influxdb/index.rst
index d186e91d12..0273013aa5 100644
--- a/docs/apache-airflow-providers-influxdb/index.rst
+++ b/docs/apache-airflow-providers-influxdb/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-influxdb``
=======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/influxdb/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -50,6 +61,7 @@ Content
Installing from sources <installing-providers-from-sources>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -59,6 +71,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -98,5 +111,3 @@ PIP package Version required
``influxdb-client`` ``>=1.19.0``
``requests`` ``>=2.26.0``
=================== ==================
-
-.. include:: ../../airflow/providers/influxdb/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-influxdb/security.rst b/docs/apache-airflow-providers-influxdb/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-influxdb/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-jdbc/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-jdbc/changelog.rst
index 450e8ed420..e8ff084db2 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-jdbc/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-jdbc``
+-----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/jdbc/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-jdbc/index.rst b/docs/apache-airflow-providers-jdbc/index.rst
index 0d6882ea38..bcffc790c8 100644
--- a/docs/apache-airflow-providers-jdbc/index.rst
+++ b/docs/apache-airflow-providers-jdbc/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-jdbc``
=================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Connection types <connections/jdbc>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/jdbc/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-jdbc 4.0.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-jdbc-4.0.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-jdbc-4.0.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-jdbc-4.0.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-jdbc 4.0.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_jdbc-4.0.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_jdbc-4.0.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_jdbc-4.0.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/jdbc/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-jdbc/security.rst b/docs/apache-airflow-providers-jdbc/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-jdbc/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-jenkins/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-jenkins/changelog.rst
index 450e8ed420..c8b1b0600a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-jenkins/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-jenkins``
+--------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/jenkins/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-jenkins/index.rst b/docs/apache-airflow-providers-jenkins/index.rst
index cce710a1d2..0dac91f654 100644
--- a/docs/apache-airflow-providers-jenkins/index.rst
+++ b/docs/apache-airflow-providers-jenkins/index.rst
@@ -19,15 +19,25 @@
``apache-airflow-providers-jenkins``
====================================
-Content
--------
+
+.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Connection types <connections>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -35,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/jenkins/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -51,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -89,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``python-jenkins`` ``>=1.0.0``
================== ==================
-
-.. include:: ../../airflow/providers/jenkins/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-jenkins/security.rst b/docs/apache-airflow-providers-jenkins/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-jenkins/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-microsoft-azure/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-microsoft-azure/changelog.rst
index 450e8ed420..5bf8a1b215 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-microsoft-azure/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-microsoft-azure``
+----------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/microsoft/azure/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-azure/index.rst b/docs/apache-airflow-providers-microsoft-azure/index.rst
index 615e7caf1a..5820216b13 100644
--- a/docs/apache-airflow-providers-microsoft-azure/index.rst
+++ b/docs/apache-airflow-providers-microsoft-azure/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-microsoft-azure``
============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -32,6 +40,7 @@ Content
Logging for Tasks <logging/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -39,11 +48,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/microsoft/azure/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -55,6 +66,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -139,5 +151,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-microsoft-azure 6.1.2 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-azure-6.1.2.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-azure-6.1.2.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-azure-6.1.2.tar.gz.sha512>`__)
* `The apache-airflow-providers-microsoft-azure 6.1.2 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_azure-6.1.2-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_azure-6.1.2-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_azure-6.1.2-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/microsoft/azure/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-azure/security.rst b/docs/apache-airflow-providers-microsoft-azure/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-microsoft-azure/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-microsoft-mssql/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-microsoft-mssql/changelog.rst
index 450e8ed420..739c6b8b62 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-microsoft-mssql/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-microsoft-mssql``
+----------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/microsoft/mssql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-mssql/index.rst b/docs/apache-airflow-providers-microsoft-mssql/index.rst
index a74410ded9..aaf868118c 100644
--- a/docs/apache-airflow-providers-microsoft-mssql/index.rst
+++ b/docs/apache-airflow-providers-microsoft-mssql/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-microsoft-mssql``
============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/microsoft/mssql/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-microsoft-mssql 3.4.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-mssql-3.4.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-mssql-3.4.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-microsoft-mssql-3.4.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-microsoft-mssql 3.4.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_mssql-3.4.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_mssql-3.4.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_microsoft_mssql-3.4.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/microsoft/mssql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-mssql/security.rst b/docs/apache-airflow-providers-microsoft-mssql/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-microsoft-mssql/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-microsoft-psrp/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-microsoft-psrp/changelog.rst
index 450e8ed420..07d8e032d5 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-microsoft-psrp/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-microsoft-psrp``
+---------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/microsoft/psrp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-psrp/index.rst b/docs/apache-airflow-providers-microsoft-psrp/index.rst
index 3dc668d6f5..30361ef749 100644
--- a/docs/apache-airflow-providers-microsoft-psrp/index.rst
+++ b/docs/apache-airflow-providers-microsoft-psrp/index.rst
@@ -19,22 +19,32 @@
``apache-airflow-providers-microsoft-psrp``
===========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/microsoft/psrp/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -45,6 +55,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -85,5 +96,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``pypsrp`` ``>=0.8.0``
================== ==================
-
-.. include:: ../../airflow/providers/microsoft/psrp/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-psrp/security.rst b/docs/apache-airflow-providers-microsoft-psrp/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-microsoft-psrp/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-microsoft-winrm/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-microsoft-winrm/changelog.rst
index 450e8ed420..201bbe2df8 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-microsoft-winrm/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-microsoft-winrm``
+----------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/microsoft/winrm/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-winrm/index.rst b/docs/apache-airflow-providers-microsoft-winrm/index.rst
index fc888a1aee..29e6eae33b 100644
--- a/docs/apache-airflow-providers-microsoft-winrm/index.rst
+++ b/docs/apache-airflow-providers-microsoft-winrm/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-microsoft-winrm``
============================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/microsoft/winrm/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``pywinrm`` ``>=0.4``
================== ==================
-
-.. include:: ../../airflow/providers/microsoft/winrm/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-microsoft-winrm/security.rst b/docs/apache-airflow-providers-microsoft-winrm/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-microsoft-winrm/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-mongo/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-mongo/changelog.rst
index 450e8ed420..97e1e6c55d 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-mongo/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-mongo``
+------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/mongo/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-mongo/index.rst b/docs/apache-airflow-providers-mongo/index.rst
index 1e1c3ab121..5e0ef781f8 100644
--- a/docs/apache-airflow-providers-mongo/index.rst
+++ b/docs/apache-airflow-providers-mongo/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-mongo``
==================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -30,6 +38,7 @@ Content
Python API <_api/airflow/providers/mongo/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -40,6 +49,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -79,5 +89,3 @@ PIP package Version required
``dnspython`` ``>=1.13.0``
``pymongo`` ``>=3.6.0``
================== ==================
-
-.. include:: ../../airflow/providers/mongo/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-mongo/security.rst b/docs/apache-airflow-providers-mongo/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-mongo/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-mysql/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-mysql/changelog.rst
index 450e8ed420..7221fd9fc6 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-mysql/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-mysql``
+------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/mysql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-mysql/index.rst b/docs/apache-airflow-providers-mysql/index.rst
index 3f39b5b775..9a29fde530 100644
--- a/docs/apache-airflow-providers-mysql/index.rst
+++ b/docs/apache-airflow-providers-mysql/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-mysql``
==================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/mysql/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -124,5 +136,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-mysql 5.1.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-mysql-5.1.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-mysql-5.1.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-mysql-5.1.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-mysql 5.1.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_mysql-5.1.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_mysql-5.1.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_mysql-5.1.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/mysql/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-mysql/security.rst b/docs/apache-airflow-providers-mysql/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-mysql/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-neo4j/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-neo4j/changelog.rst
index 450e8ed420..dd14f25ba6 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-neo4j/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-neo4j``
+------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/neo4j/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-neo4j/index.rst b/docs/apache-airflow-providers-neo4j/index.rst
index 9a2924a72b..65e0b69a6c 100644
--- a/docs/apache-airflow-providers-neo4j/index.rst
+++ b/docs/apache-airflow-providers-neo4j/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-neo4j``
==================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,6 +38,7 @@ Content
Operators <operators/neo4j>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -37,11 +46,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/neo4j/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -53,6 +64,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -91,5 +103,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``neo4j`` ``>=4.2.1``
================== ==================
-
-.. include:: ../../airflow/providers/neo4j/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-neo4j/security.rst b/docs/apache-airflow-providers-neo4j/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-neo4j/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-odbc/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-odbc/changelog.rst
index 450e8ed420..58166fe379 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-odbc/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-odbc``
+-----------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/odbc/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-odbc/index.rst b/docs/apache-airflow-providers-odbc/index.rst
index 1c751294fd..d6dbffd11b 100644
--- a/docs/apache-airflow-providers-odbc/index.rst
+++ b/docs/apache-airflow-providers-odbc/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-odbc``
=================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Connection types <connections/odbc>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -41,6 +50,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -108,5 +118,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-odbc 4.0.0 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-odbc-4.0.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-odbc-4.0.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-odbc-4.0.0.tar.gz.sha512>`__)
* `The apache-airflow-providers-odbc 4.0.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_odbc-4.0.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_odbc-4.0.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_odbc-4.0.0-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/odbc/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-odbc/security.rst b/docs/apache-airflow-providers-odbc/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-odbc/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-openfaas/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-openfaas/changelog.rst
index 450e8ed420..9a2ff34f48 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-openfaas/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-openfaas``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/openfaas/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-openfaas/index.rst b/docs/apache-airflow-providers-openfaas/index.rst
index 393f9fecad..319e37a3aa 100644
--- a/docs/apache-airflow-providers-openfaas/index.rst
+++ b/docs/apache-airflow-providers-openfaas/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-openfaas``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/openfaas/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -39,6 +48,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -76,5 +86,3 @@ PIP package Version required
================== ==================
``apache-airflow`` ``>=2.4.0``
================== ==================
-
-.. include:: ../../airflow/providers/openfaas/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-openfaas/security.rst b/docs/apache-airflow-providers-openfaas/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-openfaas/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-openlineage/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-openlineage/changelog.rst
index 450e8ed420..8d5ab5278a 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-openlineage/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-openlineage``
+------------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/openlineage/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-openlineage/index.rst b/docs/apache-airflow-providers-openlineage/index.rst
index 4793015162..7f9f22224e 100644
--- a/docs/apache-airflow-providers-openlineage/index.rst
+++ b/docs/apache-airflow-providers-openlineage/index.rst
@@ -19,40 +19,53 @@
``apache-airflow-providers-openlineage``
========================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: User guide
Guides <guides/user>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Developer guide
Guides <guides/developer>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Structure of provider
Guides <guides/structure>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Macros
Macros <macros>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/openlineage/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -63,6 +76,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
diff --git a/docs/apache-airflow-providers-openlineage/security.rst b/docs/apache-airflow-providers-openlineage/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-openlineage/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-opsgenie/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-opsgenie/changelog.rst
index 450e8ed420..58a0083310 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-opsgenie/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-opsgenie``
+---------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/opsgenie/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-opsgenie/index.rst b/docs/apache-airflow-providers-opsgenie/index.rst
index f5249c6071..ddf50d6257 100644
--- a/docs/apache-airflow-providers-opsgenie/index.rst
+++ b/docs/apache-airflow-providers-opsgenie/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-opsgenie``
=====================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
@@ -36,11 +45,13 @@ Content
.. toctree::
:hidden:
+ :maxdepth: 1
:caption: System tests
System Tests <_api/tests/system/providers/opsgenie/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -52,6 +63,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -90,5 +102,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``opsgenie-sdk`` ``>=2.1.5``
================== ==================
-
-.. include:: ../../airflow/providers/opsgenie/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-opsgenie/security.rst b/docs/apache-airflow-providers-opsgenie/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-opsgenie/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-oracle/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-oracle/changelog.rst
index 450e8ed420..ac5231a1d1 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-oracle/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-oracle``
+-------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/oracle/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-oracle/index.rst b/docs/apache-airflow-providers-oracle/index.rst
index 0ff4877b28..6073068da8 100644
--- a/docs/apache-airflow-providers-oracle/index.rst
+++ b/docs/apache-airflow-providers-oracle/index.rst
@@ -19,10 +19,18 @@
``apache-airflow-providers-oracle``
===================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -30,12 +38,14 @@ Content
Operators <operators/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/oracle/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -47,6 +57,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -114,5 +125,3 @@ You can download officially released packages and verify their checksums and sig
* `The apache-airflow-providers-oracle 3.7.1 sdist package <https://downloads.apache.org/airflow/providers/apache-airflow-providers-oracle-3.7.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache-airflow-providers-oracle-3.7.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache-airflow-providers-oracle-3.7.1.tar.gz.sha512>`__)
* `The apache-airflow-providers-oracle 3.7.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-3.7.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-3.7.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-3.7.1-py3-none-any.whl.sha512>`__)
-
-.. include:: ../../airflow/providers/oracle/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-oracle/security.rst b/docs/apache-airflow-providers-oracle/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-oracle/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-pagerduty/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-pagerduty/changelog.rst
index 450e8ed420..c463d381ad 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-pagerduty/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-pagerduty``
+----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/pagerduty/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-pagerduty/index.rst b/docs/apache-airflow-providers-pagerduty/index.rst
index 5d3223069e..7d76580e64 100644
--- a/docs/apache-airflow-providers-pagerduty/index.rst
+++ b/docs/apache-airflow-providers-pagerduty/index.rst
@@ -19,16 +19,25 @@
``apache-airflow-providers-pagerduty``
======================================
-Content
--------
.. toctree::
+ :hidden:
+ :maxdepth: 1
+ :caption: Basics
+
+ Home <self>
+ Changelog <changelog>
+ Security <security>
+
+.. toctree::
+ :hidden:
:maxdepth: 1
:caption: References
Python API <_api/airflow/providers/pagerduty/index>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Resources
@@ -36,6 +45,7 @@ Content
Installing from sources <installing-providers-from-sources>
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Guides
@@ -45,6 +55,7 @@ Content
.. toctree::
+ :hidden:
:maxdepth: 1
:caption: Commits
@@ -83,5 +94,3 @@ PIP package Version required
``apache-airflow`` ``>=2.4.0``
``pdpyras`` ``>=4.1.2``
================== ==================
-
-.. include:: ../../airflow/providers/pagerduty/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-pagerduty/security.rst b/docs/apache-airflow-providers-pagerduty/security.rst
new file mode 100644
index 0000000000..66c6f79a4e
--- /dev/null
+++ b/docs/apache-airflow-providers-pagerduty/security.rst
@@ -0,0 +1,38 @@
+
+ .. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ .. http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Releasing security patches
+--------------------------
+
+Airflow providers are released independently from Airflow itself and the information about vulnerabilities
+is published separately. You can upgrade providers independently from Airflow itself, following the
+instructions found in :doc:`apache-airflow:installation/installing-from-pypi`.
+
+When we release Provider version, the development is always done from the ``main`` branch where we prepare
+the next version. The provider uses strict `SemVer <https://semver.org>`_ versioning policy. Depending on
+the scope of the change, Provider will get ''MAJOR'' version upgrade when there are
+breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade
+when there are only bug fixes (including security bugfixes) - and this is the only version that receives
+security fixes by default, so you should upgrade to latest version of the provider if you want to receive
+all released security fixes.
+
+The only exception to that rule is when we have a critical security fix and good reason to provide an
+out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick
+and prepare a branch for an older version of the provider following the
+`mixed governance model <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#mixed-governance-model>`_
+and requires interested parties to cherry-pick and test the fixes.
diff --git a/airflow/providers/apprise/CHANGELOG.rst b/docs/apache-airflow-providers-papermill/changelog.rst
similarity index 72%
copy from airflow/providers/apprise/CHANGELOG.rst
copy to docs/apache-airflow-providers-papermill/changelog.rst
index 450e8ed420..4340d544f2 100644
--- a/airflow/providers/apprise/CHANGELOG.rst
+++ b/docs/apache-airflow-providers-papermill/changelog.rst
@@ -1,3 +1,4 @@
+
.. Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -15,8 +16,7 @@
specific language governing permissions and limitations
under the License.
+Package ``apache-airflow-providers-papermill``
+----------------------------------------------
-.. NOTE TO CONTRIBUTORS:
- Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes
- and you want to add an explanation to the users on how they are supposed to deal with them.
- The changelog is updated and maintained semi-automatically by release manager.
+.. include:: ../../airflow/providers/papermill/CHANGELOG.rst
diff --git a/docs/apache-airflow-providers-papermill/index.rst b/docs/apache-airflow-providers-papermill/index.rst
index 6e4d137672..70bb25f719 100644
--- a/docs/apache-airflow-providers-papermill/index.rst
+++ b/docs/apache-airflow-providers-papermill/index.rst
... 3021 lines suppressed ...