Skip to content

Add Airflow 3 development readme - #41457

Merged
eladkal merged 15 commits into
apache:mainfrom
eladkal:airflow3
Sep 11, 2024
Merged

Add Airflow 3 development readme#41457
eladkal merged 15 commits into
apache:mainfrom
eladkal:airflow3

Conversation

@eladkal

Copy link
Copy Markdown
Contributor

Lets have a doc that list the protocols we accepted for development of Airflow 3

Comment threaddev/README_AIRFLOW3_DEV.md Outdated

@kaxilkaxil left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One point of discussion is comments -- other than that lgtm

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
@uranusjr

Copy link
Copy Markdown
Member

Also, since I just opened a backport PR (#41469)

Is it expected to not have CI run? Should at least some test jobs run?

@potiuk

Copy link
Copy Markdown
Member

Also, since I just opened a backport PR (#41469)

Is it expected to not have CI run? Should at least some test jobs run?

#41474 -> PRs workflows were only enabled for main. It might need some more fixes, but let's merge it to main and close/reopen your PR to see if it will succeed.

@jscheffljscheffl left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the documentation. Some clarifications and proposals in ordering, else from content I agree - therefore approve.

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated

@amoghrajeshamoghrajesh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eladkal this looks great, had a couple of comments and one qn.
BTW, should we also have a section that tells how to decide if a PR is supposed to go into AF3 or 2.10.x?

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated

@amoghrajeshamoghrajesh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
@kaxil

Copy link
Copy Markdown
Member

Pre-commit (doctoc) is failing

+- [Milestones for PR](#milestones-for-pr)
+ - [Set 2.10.x milestone](#set-210x-milestone)
+ - [Set 2.11 milestone](#set-211-milestone)
+ - [Set 3 milestone](#set-3-milestone)

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
@jscheffl

Copy link
Copy Markdown
Contributor

Pre-commit (doctoc) is failing

+- [Milestones for PR](#milestones-for-pr)
+ - [Set 2.10.x milestone](#set-210x-milestone)
+ - [Set 2.11 milestone](#set-211-milestone)
+ - [Set 3 milestone](#set-3-milestone)

If we need to find more things that we need to take care as committer/PMS, we might really re-structure not from the role of contributor/committer but but it in the reversed order to describe per use case and have a checklist per PR what we should do? Will there be more things coming?

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
@eladkal

Copy link
Copy Markdown
ContributorAuthor

If we need to find more things that we need to take care as committer/PMS, we might really re-structure not from the role of contributor/committer but but it in the reversed order to describe per use case and have a checklist per PR what we should do? Will there be more things coming?

We can always change the doc structure (even now if you have a suggestion to make it more friendly)
I assume we will add/remove stuff as we move forward. For example after 2.11 the 2.10 branch related stuff won't be needed.

Comment threaddev/README_AIRFLOW3_DEV.md Outdated

@hussein-awalahussein-awala left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea!

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated

@shahar1shahar1 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM - my comments are mostly regarding proofreading and style (apologies in advance for nitpicking).
General suggestion - being consistent when referring to a single or multiple PRs.

Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
Comment threaddev/README_AIRFLOW3_DEV.md Outdated
@eladkal

Copy link
Copy Markdown
ContributorAuthor

Merging. We can iterate/change the doc as needed

@eladkal
eladkal merged commit 25cc8b2 into apache:mainSep 11, 2024
@eladkal
eladkal deleted the airflow3 branch September 11, 2024 18:19
@eladkaleladkal added the changelog:skip Changes that should be skipped from the changelog (CI, tests, etc..) label Sep 11, 2024
joaopamaral pushed a commit to joaopamaral/airflow that referenced this pull request Oct 21, 2024
* Add Airflow 3 development readme
* fix typo
* Update dev/README_AIRFLOW3_DEV.md
Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
* restructure doc
* fix static checks
* updates
* fixes
* fix spell checks
* clarify cherry picking
* add milestones
* fix doc
* Update dev/README_AIRFLOW3_DEV.md
Co-authored-by: Ephraim Anierobi <splendidzigy24@gmail.com>
* add 2.11 mental model
* Update dev/README_AIRFLOW3_DEV.md
Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
* fixes
---------
Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
Co-authored-by: Ephraim Anierobi <splendidzigy24@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-toolschangelog:skipChanges that should be skipped from the changelog (CI, tests, etc..)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants

@eladkal@uranusjr@potiuk@kaxil@jscheffl@ephraimbuddy@hussein-awala@amoghrajesh@shahar1