diff --git a/docs/conf.py b/docs/conf.py
index 1f20af6190..9167b636f6 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -50,6 +50,7 @@
"image_dark": "cosmos-icon.svg",
},
"footer_start": ["copyright"],
+ "show_nav_level": 0,
}
generate_mapping_docs()
diff --git a/docs/contributing.rst b/docs/contributing.rst
index 006149faac..d50c120398 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -155,17 +155,19 @@ To run the checks manually, run:
Writing Docs
____________
-`Hatch `_ is a unified command-line tool for managing dependencies and environment isolation for Python developers. In Cosmos, we use a Hatchto declare the dependencies required for the project itself, as well as for tests and documentation builds.
+`Hatch `_ is a unified command-line tool for managing dependencies and environment isolation for Python developers. In Cosmos, we use a Hatch to declare the dependencies required for the project itself, as well as for tests and documentation builds.
If you don’t already have Hatch installed, please `install it `_ before proceeding. As an example, on macOS, you can do so with:
.. code-block:: bash
+
brew install hatch
You can run the docs locally by running the following:
.. code-block:: bash
+
hatch run docs:serve
diff --git a/docs/getting_started/astro.rst b/docs/getting_started/astro.rst
index b590575f2e..56e9fa0d53 100644
--- a/docs/getting_started/astro.rst
+++ b/docs/getting_started/astro.rst
@@ -1,7 +1,7 @@
.. _astro:
-Getting Started on Astro
-========================
+Getting Started with Cosmos on Astro
+====================================
While it is possible to use Cosmos on Astro with all :ref:`Execution Modes `, we recommend using the ``local`` execution mode. It's the simplest to set up and use.
diff --git a/docs/getting_started/dbt-airflow-concepts.rst b/docs/getting_started/dbt-airflow-concepts.rst
index 70c4feae8d..ee55abe694 100644
--- a/docs/getting_started/dbt-airflow-concepts.rst
+++ b/docs/getting_started/dbt-airflow-concepts.rst
@@ -1,7 +1,7 @@
.. _dbt-airflow-concepts:
-Similar dbt & Airflow concepts
-==============================
+Similar dbt and Airflow concepts
+================================
While dbt is an open source tool for data transformations and analysis, using SQL, Airflow focuses on being a platform
for the development, scheduling and monitoring of batch-oriented workflows, using Python. Although both tools have many
diff --git a/docs/getting_started/index.rst b/docs/getting_started/index.rst
index 2bb43dfa3f..5168f32cde 100644
--- a/docs/getting_started/index.rst
+++ b/docs/getting_started/index.rst
@@ -1,27 +1,41 @@
.. _getting-started:
.. toctree::
+ :maxdepth: 1
:hidden:
- :caption: Contents:
+ :caption: Cosmos Fundamentals
+ Similar dbt and Airflow concepts
+
+.. toctree::
+ :maxdepth: 1
+ :hidden:
+ :caption: Get started with Cosmos
+
+ Open-source Airflow
Astro
- MWAA
- GCC
- Open-Source
+ Google Cloud Composer (GCC)
+ Amazon Managed Workflows for Apache Airflow (MWAA)
+
+
+.. toctree::
+ :maxdepth: 1
+ :hidden:
+ :caption: Execution modes and customization
+
Execution Modes
+ execution-modes-local-conflicts
Docker Execution Mode
Kubernetes Execution Mode
Azure Container Instance Execution Mode
- AWS Container Run Job Execution Mode
+ AWS Elastic Container Services (ECS) Execution Mode
GCP Cloud Run Job Execution Mode
Airflow Async Execution Mode
Watcher Execution Mode
Watcher Kubernetes Execution Mode
- dbt and Airflow Similar Concepts
Operators
Custom Airflow Properties
-
Getting Started
===============
diff --git a/docs/getting_started/mwaa.rst b/docs/getting_started/mwaa.rst
index 5b7c41bde5..5b1da23439 100644
--- a/docs/getting_started/mwaa.rst
+++ b/docs/getting_started/mwaa.rst
@@ -1,7 +1,7 @@
.. _mwaa:
-Getting Started on MWAA
-=======================
+Getting Started with Cosmos on Amazon Managed Workflows
+=======================================================
Users can face Python dependency issues when trying to use the Cosmos `Local Execution Mode `_ in Amazon Managed Workflows for `Apache Airflow® `_ (MWAA).
diff --git a/docs/getting_started/open-source.rst b/docs/getting_started/open-source.rst
index ba9bbdb15c..f5d1db832b 100644
--- a/docs/getting_started/open-source.rst
+++ b/docs/getting_started/open-source.rst
@@ -1,7 +1,7 @@
.. _open-source:
-Getting Started on Open Source Airflow
-======================================
+Getting Started with Cosmos on Open-source Airflow
+==================================================
When running open-source Airflow, your setup may vary. This guide assumes you have access to edit the underlying image.
diff --git a/docs/index.rst b/docs/index.rst
index beee4f40bb..257f892424 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -2,7 +2,7 @@
.. toctree::
:hidden:
- :maxdepth: 2
+ :maxdepth: 1
:caption: Contents:
Home