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 c7f37a9 make the providers operators/hooks reference much more usable
(#17768)
c7f37a9 is described below
commit c7f37a946dae612b382497c3252b60a821a05f1f
Author: Jarek Potiuk <[email protected]>
AuthorDate: Sat Aug 21 19:47:13 2021 +0200
make the providers operators/hooks reference much more usable (#17768)
The providers operators/hooks reference contained only top-level list of
groups of providers, which make them less-usable than they could be as
the users did not see at this page links to particular operators/hooks,
it was not really visible what is "available" (discoverability) and
the more detailed "Service" and "Transfer" pages are not really
readable enough to give "at a glance" overview what is available.
This change improves that, removes the repeated multiple times
"operators and hooks" which was kind of annoying, and increases
the TOC-level to 3 giving a nice overview of all available and
exposed operator and hooks.
---
docs/apache-airflow-providers/operators-and-hooks-ref/apache.rst | 8 ++++----
docs/apache-airflow-providers/operators-and-hooks-ref/aws.rst | 8 ++++----
docs/apache-airflow-providers/operators-and-hooks-ref/azure.rst | 8 ++++----
docs/apache-airflow-providers/operators-and-hooks-ref/google.rst | 8 ++++----
docs/apache-airflow-providers/operators-and-hooks-ref/index.rst | 2 +-
.../apache-airflow-providers/operators-and-hooks-ref/protocol.rst | 8 ++++----
.../apache-airflow-providers/operators-and-hooks-ref/services.rst | 8 ++++----
.../apache-airflow-providers/operators-and-hooks-ref/software.rst | 8 ++++----
8 files changed, 29 insertions(+), 29 deletions(-)
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/apache.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/apache.rst
index b53d90a..96c87d1 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/apache.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/apache.rst
@@ -20,8 +20,8 @@ ASF: Apache Software Foundation
Airflow supports various software created by `Apache Software Foundation
<https://www.apache.org/foundation/>`__.
-Software operators and hooks
-----------------------------
+Software
+--------
These integrations allow you to perform various operations within software
developed by Apache Software
Foundation.
@@ -31,8 +31,8 @@ Foundation.
:header-separator: "
-Transfer operators and hooks
-----------------------------
+Transfers
+---------
These integrations allow you to copy data from/to software developed by Apache
Software
Foundation.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/aws.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/aws.rst
index c551473..0b39ea5 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/aws.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/aws.rst
@@ -24,8 +24,8 @@ Airflow has support for `Amazon Web Services
<https://aws.amazon.com/>`__.
All hooks are based on :mod:`airflow.providers.amazon.aws.hooks.base_aws`.
-Service operators and hooks
-'''''''''''''''''''''''''''
+Services
+''''''''
These integrations allow you to perform various operations within the Amazon
Web Services.
@@ -33,8 +33,8 @@ These integrations allow you to perform various operations
within the Amazon Web
:tags: aws
:header-separator: "
-Transfer operators and hooks
-''''''''''''''''''''''''''''
+Transfers
+'''''''''
These integrations allow you to copy data from/to Amazon Web Services.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/azure.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/azure.rst
index b2eb937..7e4b830 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/azure.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/azure.rst
@@ -23,8 +23,8 @@ Airflow has limited support for `Microsoft Azure
<https://azure.microsoft.com/>`
Some hooks are based on
:mod:`airflow.providers.microsoft.azure.hooks.base_azure`
which authenticate Azure's Python SDK Clients.
-Service operators and hooks
-'''''''''''''''''''''''''''
+Services
+''''''''
These integrations allow you to perform various operations within the
Microsoft Azure.
@@ -32,8 +32,8 @@ These integrations allow you to perform various operations
within the Microsoft
:tags: azure
:header-separator: "
-Transfer operators and hooks
-''''''''''''''''''''''''''''
+Transfers
+'''''''''
These integrations allow you to copy data from/to Microsoft Azure.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/google.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/google.rst
index 4c67c52..762ea0e 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/google.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/google.rst
@@ -41,8 +41,8 @@ Airflow has extensive support for the `Google Cloud
<https://cloud.google.com/>`
<https://github.com/apache/airflow/tree/main/airflow/providers/google/cloud/example_dags/>`_
-Service operators and hooks
-"""""""""""""""""""""""""""
+Services
+""""""""
These integrations allow you to perform various operations within the Google
Cloud.
@@ -51,8 +51,8 @@ These integrations allow you to perform various operations
within the Google Clo
:header-separator: !
-Transfer operators and hooks
-""""""""""""""""""""""""""""
+Transfers
+"""""""""
These integrations allow you to copy data from/to Google Cloud.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/index.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/index.rst
index ceb8cc4..73fcfd5 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/index.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/index.rst
@@ -22,7 +22,7 @@ Operators and Hooks Reference
Here is a list of operators and hooks that are released independently of the
Airflow core. A list of core operators is available in the documentation for
``apache-airflow``: :doc:`Core Operators and Hooks Reference
<operators-and-hooks-ref>`.
.. toctree::
- :maxdepth: 2
+ :maxdepth: 3
:glob:
*
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/protocol.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/protocol.rst
index 650fdf3..7908f2a 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/protocol.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/protocol.rst
@@ -18,8 +18,8 @@
Protocol integrations
---------------------
-Protocol operators and hooks
-''''''''''''''''''''''''''''
+Protocols
+'''''''''
These integrations allow you to perform various operations within various
services using standardized
communication protocols or interface.
@@ -28,8 +28,8 @@ communication protocols or interface.
:tags: protocol
:header-separator: "
-Transfer operators and hooks
-''''''''''''''''''''''''''''
+Transfers
+'''''''''
These integrations allow you to copy data.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/services.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/services.rst
index ac46230..e492c3d 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/services.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/services.rst
@@ -18,8 +18,8 @@
Services
--------
-Service operators and hooks
-'''''''''''''''''''''''''''
+Services
+''''''''
These integrations allow you to perform various operations within various
services.
@@ -28,8 +28,8 @@ These integrations allow you to perform various operations
within various servic
:header-separator: "
-Transfer operators and hooks
-''''''''''''''''''''''''''''
+Transfers
+'''''''''
These integrations allow you to perform various operations within various
services.
diff --git a/docs/apache-airflow-providers/operators-and-hooks-ref/software.rst
b/docs/apache-airflow-providers/operators-and-hooks-ref/software.rst
index 5b7b240..ae4cd53 100644
--- a/docs/apache-airflow-providers/operators-and-hooks-ref/software.rst
+++ b/docs/apache-airflow-providers/operators-and-hooks-ref/software.rst
@@ -18,8 +18,8 @@
Software integrations
---------------------
-Software operators and hooks
-''''''''''''''''''''''''''''
+Software
+''''''''
These integrations allow you to perform various operations using various
software.
@@ -28,8 +28,8 @@ These integrations allow you to perform various operations
using various softwar
:header-separator: "
-Transfer operators and hooks
-''''''''''''''''''''''''''''
+Transfers
+'''''''''
These integrations allow you to copy data.