Improve “Fundamental Concepts” Tutorial and Screenshot Organization #49098
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Replaced screenshots for Airflow 3, dark mode - Added light mode screenshots for future use - Grouped dark and light screenshots together add light screenshots, and group light and dark
…hability This update rewords and restructures the Airflow “Fundamental Concepts” tutorial to improve tone, clarity, and flow. The new version is more conversational and guides users step-by-step through key Airflow concepts while keeping all code examples intact. It’s designed to be more accessible for users who are new to Airflow but have some technical background. No changes were made to licensing or code snippets.
jason810496
reviewed
Apr 11, 2025
Member
jason810496
left a comment
jason810496
left a comment
There was a problem hiding this comment.
Thanks for the change! Looks great!
However, the static check isn’t happy — we need to use double backticks for code blocks to fix it.
Check if RST files use double backticks for code............................Failed
- hook id: rst-backticks
- exit code: 1
airflow-core/docs/tutorial/fundamentals.rst:83:`dag_id`, and specify the default arguments we just defined. We'll also set a schedule for our DAG to run every day.
airflow-core/docs/tutorial/fundamentals.rst:146:`{{ ds }}`. You can also pass files to the ``bash_command``, such as ``bash_command='templated_command.sh'``, allowing
airflow-core/docs/tutorial/fundamentals.rst:176:In Airflow, tasks can depend on one another. For instance, if you have tasks `t1`, `t2`, and `t3`, you can defined their
airflow-core/docs/tutorial/fundamentals.rst:232:`tutorial.py` within the dags folder specified in your ``airflow.cfg``, you can run:
…ocs-update-fundamentals
Collaborator
Author
|
Thanks @jason810496! On me. I ran pre-commit manually before submitting the PR, but didn't verify with breeze. Pushed it through, hopefully the static tests pass. |
kaxil
reviewed
Apr 11, 2025
kaxil
approved these changes
Apr 11, 2025
Co-authored-by: Kaxil Naik <kaxilnaik@gmail.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR improves the Airflow "Fundamental Concepts" tutorial by rewriting for better clarity, structure, and tone. It also updates screenshots for Airflow 3.
Related:
What's Included
Why This Matters
The existing tutorial content was technically accurate but written in a style that could be intimidating or confusing for newcomers. This update provides a more natural learning path for users familiar with Python but new to Airflow, helping them build confidence as they go. Also: We need to update screenshots for Airflow 3 😄 and since I was there, I couldn't help but adjust it.