potiuk commented on PR #38155:
URL: https://github.com/apache/airflow/pull/38155#issuecomment-2034347911

   I am not a big fan of splitting PRs like that. If we decide to add 
something, then big part of the change is to tell the users other than author 
how to use it. That's a big difference between implementing somethign for "me" 
vs. for "all users".
   
   And there is very practical  reason to have it in one PR -  if we decide to 
cherry-pick that one to 2.9.0 or 2.9.1 (for example) , we will have to remember 
about cherry-picking yet another PR with documentation. This is not something 
that makes release manager's life easy and, really not a release manager's job 
to track and remember about those related PRs that should also be 
cherry-picked. If you imagine that release manager has 60 or 70 PRs to 
cherry-pick, choosing and cherry-picking them is enough of a task to not add a 
burden to go through all of them look through all the discussions in PR and see 
"hey there is also that 2nd PR with documentation that I have to cherry-pick as 
well". This is largely impossible task to do if you put yourself in the release 
manager shoes. Comparing to that - adding a paragraph or so documentation to 
the PR while it is being worked on is far more focused work that just "makes 
sense" to be done together.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to