Add example DAGs to provider docs (#12528)

mik-laj · web-flow · commit f2569de7d1a7 · 2020-11-22T08:53:28.000+01:00
diff --git a/docs/apache-airflow-providers-amazon/index.rst b/docs/apache-airflow-providers-amazon/index.rst
@@ -26,3 +26,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/amazon/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/amazon/aws/example_dags>
diff --git a/docs/apache-airflow-providers-apache-cassandra/index.rst b/docs/apache-airflow-providers-apache-cassandra/index.rst
@@ -26,3 +26,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/cassandra/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/cassandra/example_dags>
diff --git a/docs/apache-airflow-providers-apache-hive/index.rst b/docs/apache-airflow-providers-apache-hive/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/hive/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/hive/example_dags>
diff --git a/docs/apache-airflow-providers-apache-kylin/index.rst b/docs/apache-airflow-providers-apache-kylin/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/kylin/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/kylin/example_dags>
diff --git a/docs/apache-airflow-providers-apache-livy/index.rst b/docs/apache-airflow-providers-apache-livy/index.rst
@@ -26,3 +26,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/livy/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/livy/example_dags>
diff --git a/docs/apache-airflow-providers-apache-pig/index.rst b/docs/apache-airflow-providers-apache-pig/index.rst
@@ -26,3 +26,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/pig/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/pig/example_dags>
diff --git a/docs/apache-airflow-providers-apache-spark/index.rst b/docs/apache-airflow-providers-apache-spark/index.rst
@@ -26,3 +26,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/apache/spark/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/apache/spark/example_dags>
diff --git a/docs/apache-airflow-providers-cncf-kubernetes/index.rst b/docs/apache-airflow-providers-cncf-kubernetes/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/cncf/kubernetes/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/cncf/kubernetes/example_dags>
diff --git a/docs/apache-airflow-providers-databricks/index.rst b/docs/apache-airflow-providers-databricks/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/databricks/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/databricks/example_dags>
diff --git a/docs/apache-airflow-providers-dingding/index.rst b/docs/apache-airflow-providers-dingding/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/dingding/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/dingding/example_dags>
diff --git a/docs/apache-airflow-providers-docker/index.rst b/docs/apache-airflow-providers-docker/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/docker/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/docker/example_dags>
diff --git a/docs/apache-airflow-providers-google/example-dags.rst b/docs/apache-airflow-providers-google/example-dags.rst
@@ -0,0 +1,27 @@
+ .. 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.
+
+Example DAGS
+============
+
+You can learn how to use Google integrations by analyzing the source code of the example DAGs:
+
+* `Google Ads <https://github.com/apache/airflow/tree/master/airflow/providers/google/ads/example_dags>`__
+* `Google Cloud <https://github.com/apache/airflow/tree/master/airflow/providers/google/cloud/example_dags>`__
+* `Google Firebase <https://github.com/apache/airflow/tree/master/airflow/providers/google/firebase/example_dags>`__
+* `Google Marketing Platform <https://github.com/apache/airflow/tree/master/airflow/providers/google/marketing_platform/example_dags>`__
+* `Google Workplace <https://github.com/apache/airflow/tree/master/airflow/providers/google/suite/example_dags>`__ (formerly Google Suite)
diff --git a/docs/apache-airflow-providers-google/index.rst b/docs/apache-airflow-providers-google/index.rst
@@ -37,3 +37,9 @@ Content
 
     Python API <_api/airflow/providers/google/index>
     Configuration <configurations-ref>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <example-dags>
diff --git a/docs/apache-airflow-providers-http/index.rst b/docs/apache-airflow-providers-http/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/http/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/http/example_dags>
diff --git a/docs/apache-airflow-providers-jdbc/index.rst b/docs/apache-airflow-providers-jdbc/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/jdbc/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/jdbc/example_dags>
diff --git a/docs/apache-airflow-providers-jenkins/index.rst b/docs/apache-airflow-providers-jenkins/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/jenkins/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/jenkins/example_dags>
diff --git a/docs/apache-airflow-providers-microsoft-azure/index.rst b/docs/apache-airflow-providers-microsoft-azure/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/microsoft/azure/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/microsoft/azure/example_dags>
diff --git a/docs/apache-airflow-providers-microsoft-winrm/index.rst b/docs/apache-airflow-providers-microsoft-winrm/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/microsoft/winrm/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/microsoft/winrm/example_dags>
diff --git a/docs/apache-airflow-providers-mysql/index.rst b/docs/apache-airflow-providers-mysql/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/mysql/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/mysql/example_dags>
diff --git a/docs/apache-airflow-providers-papermill/index.rst b/docs/apache-airflow-providers-papermill/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/papermill/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/papermill/example_dags>
diff --git a/docs/apache-airflow-providers-plexus/index.rst b/docs/apache-airflow-providers-plexus/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/plexus/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/plexus/example_dags>
diff --git a/docs/apache-airflow-providers-qubole/index.rst b/docs/apache-airflow-providers-qubole/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/qubole/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/qubole/example_dags>
diff --git a/docs/apache-airflow-providers-salesforce/index.rst b/docs/apache-airflow-providers-salesforce/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/salesforce/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/salesforce/example_dags>
diff --git a/docs/apache-airflow-providers-singularity/index.rst b/docs/apache-airflow-providers-singularity/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/singularity/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/singularity/example_dags>
diff --git a/docs/apache-airflow-providers-snowflake/index.rst b/docs/apache-airflow-providers-snowflake/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/snowflake/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/snowflake/example_dags>
diff --git a/docs/apache-airflow-providers-yandex/index.rst b/docs/apache-airflow-providers-yandex/index.rst
@@ -27,3 +27,9 @@ Content
     :caption: References
 
     Python API <_api/airflow/providers/yandex/index>
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Resources
+
+    Example DAGs <https://github.com/apache/airflow/tree/master/airflow/providers/yandex/example_dags>
