Re-order docs sections (#692)

This reorders doc sections and groups similar sections. - Moves dev docs at the end to focus on Concepts and Guides - Moves references to second last
astronomer · Aug 18, 2022 · d8a3967 · d8a3967
1 parent 642b5ee
commit d8a3967
Show file tree

Hide file tree

Showing 3 changed files with 22 additions and 10 deletions.
diff --git a/docs/concepts.rst b/docs/concepts.rst
@@ -72,7 +72,7 @@ This is a faster way for datasets of larger size as there is only one network ca
 .. _templating:
 
 Templating
-~~~~~~~~~~
+----------
 Templating is a powerful concept in Airflow to pass dynamic information into task instances at runtime. Templating in Airflow works exactly the same as templating with Jinja in Python: define your to-be-evaluated code between double curly braces, and the expression will be evaluated at runtime.
 
 The parameter list passed to the decorated function is also added to the context which is used to render template. For example:

diff --git a/docs/index.rst b/docs/index.rst
@@ -15,19 +15,21 @@ Welcome to astro-sdk-python's documentation!
 
 .. toctree::
    :maxdepth: 2
-   :caption: Developing Astro SDK
-   :glob:
+   :caption: Guides
+   :titlesonly:
 
-   development/*
-
-   Astro Enhancement Proposals <aep/index>
+   concepts.rst
+   operators.rst
 
 .. toctree::
    :maxdepth: 1
-   :caption: API Reference
+   :caption: Reference
    :glob:
 
    autoapi/*
+   configurations.rst
+   supported_databases.rst
+   supported_file.rst
 
 .. toctree::
    :maxdepth: 1
@@ -53,12 +55,13 @@ Welcome to astro-sdk-python's documentation!
 .. toctree::
    :maxdepth: 1
    :caption: Reference
+   :maxdepth: 2
+   :caption: Developing Astro SDK
    :glob:
 
-   configurations.rst
-   supported_databases.rst
-   supported_file.rst
+   development/*
 
+   Astro Enhancement Proposals <aep/index>
 
 Indices and Tables
 ==================

diff --git a/docs/operators.rst b/docs/operators.rst
@@ -0,0 +1,9 @@
+=========
+Operators
+=========
+
+.. toctree::
+   :glob:
+
+   astro/sql/operators/*
+   astro/files/operators/*