pankajkoti commented on code in PR #62417: URL: https://github.com/apache/airflow/pull/62417#discussion_r2853256085
########## contributing-docs/04_how_to_contribute.rst: ########## @@ -36,53 +36,111 @@ Report security issues If you want to report a security finding, please follow the `Security policy <https://github.com/apache/airflow/security/policy>`_ +Issue reporting and resolution process +====================================== + +.. note:: + **TL;DR: Quick Summary** + + * **No Issue Needed:** You can open a PR directly without opening an issue first. + * **Discussion First:** If you aren't sure about a bug or feature, start a + `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + * **No Assignments:** we do **not** assign issues to non-maintainers or people who maintainer reached out + to before. Please do not ask to be assigned; simply comment "working on it" and submit your PR. + * **Parallel Work is fine:** Multiple people can work on the same issue and it's fine while not necessarily + default. When it happens - we will merge the best implementation, and encourage learning and + community feedback. + +An unusual element of the Apache Airflow project (compared, for example, to commercial +development) is that you can open a PR to fix an issue or make an enhancement without needing +to open an issue first. This is intended to make it as easy as possible to contribute to the +project. + +If you're not sure whether it's a bug or a feature, consider starting +with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + +In case you have no clear, reproducible case for a behaviour that you identify as a bug, discussions +might If you have a significant topic to discuss where important behaviour of Airflow seems like a bug +or needs an improvement, start a thread on the +`Devlist <https://lists.apache.org/[email protected]>`_ instead. -Fix Bugs --------- +The Apache Airflow project uses a set of labels for tracking and triaging issues, as well as +a set of priorities and milestones to track how and when enhancements and bug fixes make it +into an Airflow release. This is documented as part of the +`Issue reporting and resolution process <../ISSUE_TRIAGE_PROCESS.rst>`_. -Look through the GitHub issues for bugs. Anything is open to whoever wants to implement it. +Contribute code changes +----------------------- +Note that we do not usually assign issues to people. Maintainers only self-assign issues when +they want to ensure they are working on something where they have unique knowledge or a +specific desire to work on a specific part. -Issue reporting and resolution process --------------------------------------- - -An unusual element of the Apache Airflow project is that you can open a PR to -fix an issue or make an enhancement, without needing to open an issue first. -This is intended to make it as easy as possible to contribute to the project. - -If you however feel the need to open an issue (usually a bug or feature request) -consider starting with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. -In the vast majority of cases discussions are better than issues - you should only open -issues if you are sure you found a bug and have a reproducible case, -or when you want to raise a feature request that will not require a lot of discussion. -If you have a very important topic to discuss, start a discussion on the -`Devlist <https://lists.apache.org/[email protected]>`_ instead. +As of **March 2026**, we do not expect people to ask to be assigned to issues, and we will Review Comment: ```suggestion Starting **March 2026**, we do not expect people to ask to be assigned to issues, and we will ``` ? ########## contributing-docs/04_how_to_contribute.rst: ########## @@ -36,53 +36,111 @@ Report security issues If you want to report a security finding, please follow the `Security policy <https://github.com/apache/airflow/security/policy>`_ +Issue reporting and resolution process +====================================== + +.. note:: + **TL;DR: Quick Summary** + + * **No Issue Needed:** You can open a PR directly without opening an issue first. + * **Discussion First:** If you aren't sure about a bug or feature, start a + `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + * **No Assignments:** we do **not** assign issues to non-maintainers or people who maintainer reached out Review Comment: +1 on the question if there is a word missing here? ########## contributing-docs/04_how_to_contribute.rst: ########## @@ -36,53 +36,111 @@ Report security issues If you want to report a security finding, please follow the `Security policy <https://github.com/apache/airflow/security/policy>`_ +Issue reporting and resolution process +====================================== + +.. note:: + **TL;DR: Quick Summary** + + * **No Issue Needed:** You can open a PR directly without opening an issue first. + * **Discussion First:** If you aren't sure about a bug or feature, start a + `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + * **No Assignments:** we do **not** assign issues to non-maintainers or people who maintainer reached out + to before. Please do not ask to be assigned; simply comment "working on it" and submit your PR. + * **Parallel Work is fine:** Multiple people can work on the same issue and it's fine while not necessarily + default. When it happens - we will merge the best implementation, and encourage learning and + community feedback. + +An unusual element of the Apache Airflow project (compared, for example, to commercial +development) is that you can open a PR to fix an issue or make an enhancement without needing +to open an issue first. This is intended to make it as easy as possible to contribute to the +project. + +If you're not sure whether it's a bug or a feature, consider starting +with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + +In case you have no clear, reproducible case for a behaviour that you identify as a bug, discussions +might If you have a significant topic to discuss where important behaviour of Airflow seems like a bug Review Comment: This sentence appears incomplete, `...discussion might If...` ########## contributing-docs/04_how_to_contribute.rst: ########## @@ -36,53 +36,111 @@ Report security issues If you want to report a security finding, please follow the `Security policy <https://github.com/apache/airflow/security/policy>`_ +Issue reporting and resolution process +====================================== + +.. note:: + **TL;DR: Quick Summary** + + * **No Issue Needed:** You can open a PR directly without opening an issue first. + * **Discussion First:** If you aren't sure about a bug or feature, start a + `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + * **No Assignments:** we do **not** assign issues to non-maintainers or people who maintainer reached out + to before. Please do not ask to be assigned; simply comment "working on it" and submit your PR. + * **Parallel Work is fine:** Multiple people can work on the same issue and it's fine while not necessarily + default. When it happens - we will merge the best implementation, and encourage learning and + community feedback. + +An unusual element of the Apache Airflow project (compared, for example, to commercial +development) is that you can open a PR to fix an issue or make an enhancement without needing +to open an issue first. This is intended to make it as easy as possible to contribute to the +project. + +If you're not sure whether it's a bug or a feature, consider starting +with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + +In case you have no clear, reproducible case for a behaviour that you identify as a bug, discussions +might If you have a significant topic to discuss where important behaviour of Airflow seems like a bug +or needs an improvement, start a thread on the +`Devlist <https://lists.apache.org/[email protected]>`_ instead. -Fix Bugs --------- +The Apache Airflow project uses a set of labels for tracking and triaging issues, as well as +a set of priorities and milestones to track how and when enhancements and bug fixes make it +into an Airflow release. This is documented as part of the +`Issue reporting and resolution process <../ISSUE_TRIAGE_PROCESS.rst>`_. -Look through the GitHub issues for bugs. Anything is open to whoever wants to implement it. +Contribute code changes +----------------------- +Note that we do not usually assign issues to people. Maintainers only self-assign issues when +they want to ensure they are working on something where they have unique knowledge or a +specific desire to work on a specific part. -Issue reporting and resolution process --------------------------------------- - -An unusual element of the Apache Airflow project is that you can open a PR to -fix an issue or make an enhancement, without needing to open an issue first. -This is intended to make it as easy as possible to contribute to the project. - -If you however feel the need to open an issue (usually a bug or feature request) -consider starting with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. -In the vast majority of cases discussions are better than issues - you should only open -issues if you are sure you found a bug and have a reproducible case, -or when you want to raise a feature request that will not require a lot of discussion. -If you have a very important topic to discuss, start a discussion on the -`Devlist <https://lists.apache.org/[email protected]>`_ instead. +As of **March 2026**, we do not expect people to ask to be assigned to issues, and we will +not assign them when asked. Contributors are still welcome to work on those issues and comment Review Comment: ```suggestion not assign them even if asked. Contributors are still welcome to work on those issues and comment ``` ########## contributing-docs/04_how_to_contribute.rst: ########## @@ -36,53 +36,111 @@ Report security issues If you want to report a security finding, please follow the `Security policy <https://github.com/apache/airflow/security/policy>`_ +Issue reporting and resolution process +====================================== + +.. note:: + **TL;DR: Quick Summary** + + * **No Issue Needed:** You can open a PR directly without opening an issue first. + * **Discussion First:** If you aren't sure about a bug or feature, start a + `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + * **No Assignments:** we do **not** assign issues to non-maintainers or people who maintainer reached out + to before. Please do not ask to be assigned; simply comment "working on it" and submit your PR. + * **Parallel Work is fine:** Multiple people can work on the same issue and it's fine while not necessarily + default. When it happens - we will merge the best implementation, and encourage learning and + community feedback. + +An unusual element of the Apache Airflow project (compared, for example, to commercial +development) is that you can open a PR to fix an issue or make an enhancement without needing +to open an issue first. This is intended to make it as easy as possible to contribute to the +project. + +If you're not sure whether it's a bug or a feature, consider starting +with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. + +In case you have no clear, reproducible case for a behaviour that you identify as a bug, discussions +might If you have a significant topic to discuss where important behaviour of Airflow seems like a bug +or needs an improvement, start a thread on the +`Devlist <https://lists.apache.org/[email protected]>`_ instead. -Fix Bugs --------- +The Apache Airflow project uses a set of labels for tracking and triaging issues, as well as +a set of priorities and milestones to track how and when enhancements and bug fixes make it +into an Airflow release. This is documented as part of the +`Issue reporting and resolution process <../ISSUE_TRIAGE_PROCESS.rst>`_. -Look through the GitHub issues for bugs. Anything is open to whoever wants to implement it. +Contribute code changes +----------------------- +Note that we do not usually assign issues to people. Maintainers only self-assign issues when +they want to ensure they are working on something where they have unique knowledge or a +specific desire to work on a specific part. -Issue reporting and resolution process --------------------------------------- - -An unusual element of the Apache Airflow project is that you can open a PR to -fix an issue or make an enhancement, without needing to open an issue first. -This is intended to make it as easy as possible to contribute to the project. - -If you however feel the need to open an issue (usually a bug or feature request) -consider starting with a `GitHub Discussion <https://github.com/apache/airflow/discussions>`_ instead. -In the vast majority of cases discussions are better than issues - you should only open -issues if you are sure you found a bug and have a reproducible case, -or when you want to raise a feature request that will not require a lot of discussion. -If you have a very important topic to discuss, start a discussion on the -`Devlist <https://lists.apache.org/[email protected]>`_ instead. +As of **March 2026**, we do not expect people to ask to be assigned to issues, and we will +not assign them when asked. Contributors are still welcome to work on those issues and comment +that they are "working on it", but we will not formally assign them. We used this system +previously, but found it did not work well in a landscape where: + +* Users treat assignment as a "badge". +* Users are unsure if they can follow through on the work. +* Users attempt to use Gen-AI to solve the issue and fail to deliver or lose interest. + +Consequently, we do not assign issues to anyone who is not a maintainer, unless a maintainer +knows them personally and has agreed to the work via direct communication - this requires +maintainer to actively reach out to the person before, you should not ask to be assigned. + +The "no assignment" policy is not intended to discourage contributors — quite the opposite. We +want to ensure we do not have a backlog of "assigned" issues that are not actually being +addressed. This often prevents others from working on them in parallel. Review Comment: This is nice. Probably could be bold, jk :) -- 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]
