From 4844d847db461eb3ae4608fd3bf357b101e9f3be Mon Sep 17 00:00:00 2001
From: Tatiana Al-Chueyr <tatiana.alchueyr@gmail.com>
Date: Wed, 6 Sep 2023 12:17:33 +0100
Subject: [PATCH] Address Julian's feedback on docs

---
 docs/configuration/lineage.rst | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/docs/configuration/lineage.rst b/docs/configuration/lineage.rst
index 99c37ae68..83bd3c550 100644
--- a/docs/configuration/lineage.rst
+++ b/docs/configuration/lineage.rst
@@ -10,7 +10,7 @@ and virtualenv execution methods (read `execution modes <../getting_started/exec
 To emit lineage events, Cosmos can use one of the following:
 
 1. Airflow 2.7 `built-in support to OpenLineage <https://airflow.apache.org/docs/apache-airflow-providers-openlineage/1.0.2/guides/user.html>`_, or
-2. The `openlineage-airflow <https://openlineage.io/docs/integrations/airflow/>`_ package
+2. `Additional libraries <https://openlineage.io/docs/integrations/airflow/>`_.
 
 No change to the user DAG files is required to use OpenLineage.
 
@@ -20,14 +20,22 @@ Installation
 
 If using Airflow 2.7, no other dependency is required.
 
-Otherwise, install the Python package ``astronomer-cosmos[openlineage]`` or ``openlineage-airflow``.
+Otherwise, install Cosmos using ``astronomer-cosmos[openlineage]``.
 
 
-Namespace configuration
------------------------
+Configuration
+-------------
+
+If using Airflow 2.7, follow `these instructions <https://airflow.apache.org/docs/apache-airflow-providers-openlineage/1.0.2/guides/user.html>`_ on how to configure OpenLineage.
+
+Otherwise, follow `these instructions <https://openlineage.io/docs/integrations/airflow/>`_.
+
+
+Namespace
+.........
 
 Cosmos will use the Airflow ``[openlineage]`` ``namespace`` property as a namespace, `if available <https://airflow.apache.org/docs/apache-airflow-providers-openlineage/1.0.2/guides/user.html>`_.
 
 Otherwise, it attempts to use the environment variable ``OPENLINEAGE_NAMESPACE`` as the namespace.
 
-If not defined, it uses ``"default"`` as the namespace.
+Finally, if neither are defined, it uses ``"default"`` as the namespace.