Skip to content

[DO NOT MERGE] Execution mode overview and guides update#2

Closed
lzdanski wants to merge 50 commits into
restructure-get-started-guidesfrom
execution-mode-overview
Closed

[DO NOT MERGE] Execution mode overview and guides update#2
lzdanski wants to merge 50 commits into
restructure-get-started-guidesfrom
execution-mode-overview

Conversation

@lzdanski
Copy link
Copy Markdown
Owner

@lzdanski lzdanski commented Mar 2, 2026

Description

  • Adds Redirects for all relocated files
  • Restructure of the execution modes docs and addition of the Execution Modes Map/Decision Guide doc

Adds Execution Modes Map Doc

Screenshot 2026-03-04 at 5 48 13 PM Screenshot 2026-03-04 at 5 45 52 PM Screenshot 2026-03-04 at 5 46 09 PM Screenshot 2026-03-04 at 5 46 17 PM Screenshot 2026-03-04 at 5 46 26 PM

Redistributes content from current Execution Modes page (https://astronomer.github.io/astronomer-cosmos/getting_started/execution-modes.html) to individual sub-pages

Screenshot 2026-03-04 at 5 50 10 PM Screenshot 2026-03-04 at 5 54 43 PM

Creates new 'Local Execution Mode' Page from current Execution Modes page content

Screenshot 2026-03-04 at 5 52 33 PM Screenshot 2026-03-04 at 5 52 41 PM

Creates new 'Cosmos-managed virtual environments' page from current Executions Modes page content

Screenshot 2026-03-04 at 5 53 43 PM

Moves Airflow and dbt dependency conflicts to "Troubleshooting" section.

Screenshot 2026-03-04 at 5 48 50 PM

Related Issue(s)

Breaking Change?

Checklist

  • I have made corresponding changes to the documentation (if required)
  • I have added tests that prove my fix is effective or that my feature works

@lzdanski lzdanski closed this Mar 3, 2026
@lzdanski lzdanski reopened this Mar 3, 2026
Comment thread docs/guides/run_dbt/airflow-worker/async-execution-mode.rst Outdated
Comment thread docs/guides/run_dbt/container/aws-container-run-job.rst Outdated
Comment thread docs/optimize_performance/invocation_modes.rst Outdated
Co-authored-by: Pankaj Singh <98807258+pankajastro@users.noreply.github.com>
@lzdanski lzdanski requested a review from pankajastro March 4, 2026 01:16
@lzdanski lzdanski force-pushed the restructure-get-started-guides branch from 14690a4 to 3a5957b Compare March 4, 2026 15:07
@lzdanski lzdanski changed the title Execution mode overview Execution mode overview and guides update Mar 4, 2026
@lzdanski lzdanski changed the title Execution mode overview and guides update [DO NOT MERGE] Execution mode overview and guides update Mar 4, 2026
@lzdanski lzdanski mentioned this pull request Mar 5, 2026
2 tasks
@lzdanski lzdanski force-pushed the restructure-get-started-guides branch from 2e48b97 to 1d61288 Compare March 5, 2026 17:09
tatiana pushed a commit to astronomer/astronomer-cosmos that referenced this pull request Mar 6, 2026
- Renames *Source Nodes Rendering* page to *Managing Sources* per
navigation structure discussion
- Updates all relative links so that images and code examples render as
expected
- Adds redirects for all relocated content
- Aligns getting started guide navigation labels to be more consistent

### Things this PR does **not** cover that are addressed in other PRs:

- This PR does not align titles and navigation labels for newly
relocated Execution Modes docs and overview doc
(lzdanski#2)
- It does not add additional content to newly created index landing
pages for the subfolders of the new TOC categories
- It does not add new content to the Getting Started/ Cosmos
Fundamentals section
- It does not move `Profiles` docs into `References`
(#2424)

## Restructuring work

- Restructures the Getting Started section to have a dedicated space for
core concepts called "Cosmos Fundamentals", and another section for
getting started guides.
<img width="1459" height="506" alt="Screenshot 2026-03-01 at 10 03
01 PM"
src="https://github.com/user-attachments/assets/c3e13648-bcc5-481a-958c-3e48fcb5ed6e"
/>
- Renames "Configuration" to "Guides", Moves execution modes docs from
"Getting started" to "Guides" section, adds new categories to the
"Guides" section
<img width="1462" height="787" alt="Screenshot 2026-03-01 at 10 03
08 PM"
src="https://github.com/user-attachments/assets/0a60a3d1-780c-4bb2-b40e-c643c5abb407"
/>
- Adds a new category of docs called "Optimize Performance" for advanced
configuration topics
<img width="1446" height="530" alt="Screenshot 2026-03-01 at 10 07
23 PM"
src="https://github.com/user-attachments/assets/8bba6494-4125-4704-9a64-594a66a16e6d"
/>

- Adds a section called "References" for glossary/configs/and other
reference material.
<img width="1402" height="368" alt="Screenshot 2026-03-01 at 10 07
35 PM"
src="https://github.com/user-attachments/assets/d4cf12d2-c3c4-40ce-9d19-6951514c1bc3"
/>

## Related Issue(s)

Related to the following open PR's:

- #2398
- #2416
- #2424
@lzdanski lzdanski closed this Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants