From 2f1402151d3b0aea9205c263ccfaa6fd2ae6f126 Mon Sep 17 00:00:00 2001 From: L Zdanski <25642903+lzdanski@users.noreply.github.com> Date: Fri, 13 Mar 2026 19:27:35 -0400 Subject: [PATCH 1/4] Add to sidebar --- .../render-config.rst | 2 + docs/reference/glossary.rst | 62 +++++++++++++++++++ docs/reference/index.rst | 8 +++ 3 files changed, 72 insertions(+) create mode 100644 docs/reference/glossary.rst diff --git a/docs/guides/translate_dbt_to_airflow/render-config.rst b/docs/guides/translate_dbt_to_airflow/render-config.rst index 07b74feba6..8441374315 100644 --- a/docs/guides/translate_dbt_to_airflow/render-config.rst +++ b/docs/guides/translate_dbt_to_airflow/render-config.rst @@ -1,3 +1,5 @@ +.. _render-config: + Render Config ------------- diff --git a/docs/reference/glossary.rst b/docs/reference/glossary.rst new file mode 100644 index 0000000000..cec8bd51eb --- /dev/null +++ b/docs/reference/glossary.rst @@ -0,0 +1,62 @@ +.. glossary:: + +Glossary +========= + +Cosmos + An open-source Python package that allows you to write data transofrmations using dbt + and then use Apache Airflow®'s orchestration to integrate dbt projects into end-to-end workflows. + +Dag + An Airflow term derived from the mathematical structure called **Directed Acyclic Graph**. The Dag provides + a model that includes everything needed to execute an Airflow workflow. See `Dag `_. + +dbt deps + A `dbt command `_ that pulls the most recent version of dependencies contained in your packages.yml file. + +Execution mode + The execution mode describes where and how Cosmos runs dbt commands. You configure it using the ``ExecutionConfig``. See :ref:`execution-modes`. + +Load mode + The method that Cosmos uses to parse your dbt project. See :ref:`parsing-methods`. + +Manifest + A dbt artifact that This file contains a full representation of the dbt project's resources, including all node configurations and resource properties. + See `Manifest JSON file `_ in the dbt docs. + +Node + A dbt concept that encapsulates a step within a pipeline. + +Partial parsing + Partial parsing is a dbt feature that can greatly speed up dbt parsing and execution when using the ``dbt_ls`` + load mode. See :ref:`partial-parsing`. + +Profile + The authentication information used by dbt to connect to your data warehouse. See `profile `_. + +ProfileConfig + The class that determines which data warehouse Cosmos connects to when executing the dbt SQL. See :ref:`connect_database`. + +Profile mapping + A Cosmos-provided resource that translate Airflow connections into dbt profiles. See :ref:`use-profile-mapping`. + +profiles.yml + The file where dbt stores connection information for each data warehouse connection. See :ref:`connect_database`, :ref:`use-your-profiles-yml`, + or `The profiles.yml file `_ in the dbt docs. + +ProjectConfig + The Cosmos class that allows you to specify information about where your dbt project is located and project variables that should be used for rendering and execution. + +RenderConfig + The configuration in Cosmos that controls how Cosmos turns your dbt project into an Airflow dag or task group. :ref:`render-config`. + +Task + An Airflow term describing a step within a pipeline. See `Task `_. + +Test + Refers to the the `dbt test command `_. You can configure how you want + Cosmos to handle running ``dbt test`` with :ref:`testing-behavior`. + +Workflow + A dbt term describing a pipeline that contains a group of steps. dbt can run a subset + of tasks assuming upstream tasks were run. This is similar to the Airflow concept of a `Dag `_. \ No newline at end of file diff --git a/docs/reference/index.rst b/docs/reference/index.rst index 3d2980d6a9..5efc3de65f 100644 --- a/docs/reference/index.rst +++ b/docs/reference/index.rst @@ -24,6 +24,14 @@ Reference profiles/index +.. toctree:: + :maxdepth: 1 + :hidden: + :caption: Additional resources + + glossary + + Configurations ++++++++++++++ From 6dc54185c9dda9da11357981300a26566da8e1a0 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Fri, 13 Mar 2026 23:34:01 +0000 Subject: [PATCH 2/4] =?UTF-8?q?=F0=9F=8E=A8=20[pre-commit.ci]=20Auto=20for?= =?UTF-8?q?mat=20from=20pre-commit.com=20hooks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/reference/glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/glossary.rst b/docs/reference/glossary.rst index cec8bd51eb..43a0d7d29d 100644 --- a/docs/reference/glossary.rst +++ b/docs/reference/glossary.rst @@ -59,4 +59,4 @@ Test Workflow A dbt term describing a pipeline that contains a group of steps. dbt can run a subset - of tasks assuming upstream tasks were run. This is similar to the Airflow concept of a `Dag `_. \ No newline at end of file + of tasks assuming upstream tasks were run. This is similar to the Airflow concept of a `Dag `_. From 659f9dfcdc07ff0338d7fa8ef74fd704eae285bd Mon Sep 17 00:00:00 2001 From: L Zdanski <25642903+lzdanski@users.noreply.github.com> Date: Fri, 13 Mar 2026 21:40:42 -0400 Subject: [PATCH 3/4] Fix misspelling --- docs/reference/glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/glossary.rst b/docs/reference/glossary.rst index 43a0d7d29d..d24596fddb 100644 --- a/docs/reference/glossary.rst +++ b/docs/reference/glossary.rst @@ -4,7 +4,7 @@ Glossary ========= Cosmos - An open-source Python package that allows you to write data transofrmations using dbt + An open-source Python package that allows you to write data transformations using dbt and then use Apache Airflow®'s orchestration to integrate dbt projects into end-to-end workflows. Dag From b599fff6b726a334a2fb936fad581996fa054e0d Mon Sep 17 00:00:00 2001 From: Pankaj Singh <98807258+pankajastro@users.noreply.github.com> Date: Wed, 29 Apr 2026 11:50:51 +0530 Subject: [PATCH 4/4] Apply suggestion from @pankajastro --- docs/reference/glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/glossary.rst b/docs/reference/glossary.rst index d24596fddb..fa40ae2199 100644 --- a/docs/reference/glossary.rst +++ b/docs/reference/glossary.rst @@ -5,7 +5,7 @@ Glossary Cosmos An open-source Python package that allows you to write data transformations using dbt - and then use Apache Airflow®'s orchestration to integrate dbt projects into end-to-end workflows. + and then use Apache Airflow®'s orchestration to integrate dbt projects into end-to-end workflows. Dag An Airflow term derived from the mathematical structure called **Directed Acyclic Graph**. The Dag provides