This is an automated email from the ASF dual-hosted git repository.
rnhttr pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 2a5cfa879a8 Add a section in contributors guide about working with
dags (#56362)
2a5cfa879a8 is described below
commit 2a5cfa879a8628b528b2e8454cc73c977e0f95d0
Author: Amogh Desai <[email protected]>
AuthorDate: Fri Oct 3 19:44:49 2025 +0530
Add a section in contributors guide about working with dags (#56362)
---
contributing-docs/03a_contributors_quick_start_beginners.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/contributing-docs/03a_contributors_quick_start_beginners.rst
b/contributing-docs/03a_contributors_quick_start_beginners.rst
index 3fa429ddb4a..9622b444532 100644
--- a/contributing-docs/03a_contributors_quick_start_beginners.rst
+++ b/contributing-docs/03a_contributors_quick_start_beginners.rst
@@ -87,6 +87,18 @@ and launches all Airflow necessary components in those
terminals. To know more a
check out this cheat sheet: https://tmuxcheatsheet.com/. To exit breeze, type
``start-airflow`` in any
of the tmux panes and hit Enter.
+**Working with DAGs in Breeze:**
+
+- **Adding your own DAGs**: Place your DAG files in the ``/files/dags/``
directory in your local Airflow repository. This directory is automatically
mounted into the Breeze container and your DAGs will be visible in the Airflow
UI.
+
+- **Loading example DAGs**: Use the ``--load-example-dags`` flag to load all
example DAGs from the repository:
+
+.. code-block:: bash
+
+ breeze start-airflow --load-example-dags
+
+This flag enables configuration to load example DAGs when starting Airflow,
which is useful for exploring Airflow's capabilities and testing.
+
4. **Make a tiny change** – e.g. fix a typo in docs
5. **Run local checks**
