From d8a396704310e82a1bd848ca28f9ec867f18e307 Mon Sep 17 00:00:00 2001 From: Kaxil Naik Date: Thu, 18 Aug 2022 19:24:34 +0100 Subject: [PATCH] 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 --- docs/concepts.rst | 2 +- docs/index.rst | 21 ++++++++++++--------- docs/operators.rst | 9 +++++++++ 3 files changed, 22 insertions(+), 10 deletions(-) create mode 100644 docs/operators.rst diff --git a/docs/concepts.rst b/docs/concepts.rst index daa228b9e..d07091cbb 100644 --- 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 index dde828799..cfcbae013 100644 --- 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 + 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 Indices and Tables ================== diff --git a/docs/operators.rst b/docs/operators.rst new file mode 100644 index 000000000..9c16cbdaa --- /dev/null +++ b/docs/operators.rst @@ -0,0 +1,9 @@ +========= +Operators +========= + +.. toctree:: + :glob: + + astro/sql/operators/* + astro/files/operators/*