From 82fc269c9582fd3b10086d5629aa9109bfe66772 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Thu, 25 Apr 2024 18:46:37 -0400 Subject: [PATCH 1/3] Docs: Add governance page to contributor guide --- docs/source/contributor-guide/governance.md | 93 +++++++++++++++++++++ docs/source/index.rst | 1 + 2 files changed, 94 insertions(+) create mode 100644 docs/source/contributor-guide/governance.md diff --git a/docs/source/contributor-guide/governance.md b/docs/source/contributor-guide/governance.md new file mode 100644 index 000000000000..cbc81d557175 --- /dev/null +++ b/docs/source/contributor-guide/governance.md @@ -0,0 +1,93 @@ + + +# Governance + +The current PMC and committers are listed in the [Apache Phonebook]. + +[apache phonebook]: https://projects.apache.org/committee.html?datafusion + +## Overview + +DataFusion is part of the [Apache Software Foundation] and is governed following +the [Apache Way] and [project management guidelines], [independently of +commercial interests]. + +[apache software foundation]: https://www.apache.org/ +[apache way]: https://www.apache.org/theapacheway/ +[project management guidelines]: https://www.apache.org/foundation/how-it-works.html#management +[independently of commercial interests]: https://community.apache.org/projectIndependence.html + +As much as practicable, we strive to make decisions by consensus, and anyone in +the community is encouraged to propose ideas, start discussions, and contribute +to the project. + +## Roles + +- **Contributors**: Anyone who contributes to the project, whether it be code, + documentation, testing, issue reports, code, or some other form. + +- **Committers**: Contributors who have been granted write access to the +- project's source code repository. Committers are responsible for reviewing + and merging pull requests. Committers are chosen by the PMC. + +- **Project Management Committee (PMC)**: The PMC is responsible for the +- oversight of the project. The PMC is responsible for making decisions about + the project, including the addition of new committers and PMC members. The PMC + is also responsible for [voting] on releases and ensuring that the project follows + the [Apache Way]. + +[voting]: https://www.apache.org/foundation/voting.html + +## Becoming a Committer + +Contributors with sustained, high-quality activity may be invited to become +committers by the PMC as a recognition of their contribution to the project and +their shared commitment. Committers have the significant responsibility of using +their status and access to improve the project for the entire community. + +When considering inviting someone to be a committer, the PMC looks for +contributors who are already doing the work and exercising the judgment expected +of a committer. After all, any contributor can do all of the things a committer +does except for merge a PR. While there is no set list of requirements, nor a +checklist that entitles one to commit privileges, typical behaviors include: + +- Contributions beyond pull requests, such as reviewing other pull requests, + fixing bugs and documentation, triaging issues, answering community questions, + improving usability, helping with CI, verifying releases, etc. + +- Contributions that are consistent in quality and sustained + over time, typically on the order of 6 months or more. + +- Assistance growing the size and health of the community via constructive, + respectful, and consensus driven interactions, as described in our [Code of + Conduct] and the [Apache Way]. + +If you feel you should be offered committer privileges, but have not been, you +can reach out to one of the PMC members or the private@datafusion.apache.org mailing +list. + +[code of conduct]: https://www.apache.org/foundation/policies/conduct.html + +## Becoming a PMC Member + +Committers with long term sustained contributions to the project may be invited +to join the PMC. This is a recognition of a significant contribution to growing +the community, improving the project, and helping to guide the project's +direction, typically over the course of a year or more. diff --git a/docs/source/index.rst b/docs/source/index.rst index 5944d346ca95..84d920bd66c9 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -113,4 +113,5 @@ Please see the `developer’s guide`_ for contributing and `communication`_ for contributor-guide/architecture contributor-guide/roadmap contributor-guide/quarterly_roadmap + contributor-guide/governance contributor-guide/specification/index From 252467393c1fb8ec164f945cf0237f51f819679a Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Thu, 25 Apr 2024 20:26:02 -0400 Subject: [PATCH 2/3] Update docs/source/contributor-guide/governance.md Co-authored-by: Liang-Chi Hsieh --- docs/source/contributor-guide/governance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/contributor-guide/governance.md b/docs/source/contributor-guide/governance.md index cbc81d557175..75c31dc029f4 100644 --- a/docs/source/contributor-guide/governance.md +++ b/docs/source/contributor-guide/governance.md @@ -41,7 +41,7 @@ to the project. ## Roles - **Contributors**: Anyone who contributes to the project, whether it be code, - documentation, testing, issue reports, code, or some other form. + documentation, testing, issue reports, code, or some other forms. - **Committers**: Contributors who have been granted write access to the - project's source code repository. Committers are responsible for reviewing From e9a93ddb4e1d9b8e8676a93e79ceb88b59bcefec Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 26 Apr 2024 14:27:18 -0400 Subject: [PATCH 3/3] Fix bullet points --- docs/source/contributor-guide/governance.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/source/contributor-guide/governance.md b/docs/source/contributor-guide/governance.md index 75c31dc029f4..27ff90eb92c8 100644 --- a/docs/source/contributor-guide/governance.md +++ b/docs/source/contributor-guide/governance.md @@ -43,14 +43,14 @@ to the project. - **Contributors**: Anyone who contributes to the project, whether it be code, documentation, testing, issue reports, code, or some other forms. -- **Committers**: Contributors who have been granted write access to the -- project's source code repository. Committers are responsible for reviewing - and merging pull requests. Committers are chosen by the PMC. +- **Committers**: Contributors who have been granted write access to the + project's source code repository. Committers are responsible for reviewing and + merging pull requests. Committers are chosen by the PMC. - **Project Management Committee (PMC)**: The PMC is responsible for the -- oversight of the project. The PMC is responsible for making decisions about - the project, including the addition of new committers and PMC members. The PMC - is also responsible for [voting] on releases and ensuring that the project follows + oversight of the project. The PMC is responsible for making decisions about the + project, including the addition of new committers and PMC members. The PMC is + also responsible for [voting] on releases and ensuring that the project follows the [Apache Way]. [voting]: https://www.apache.org/foundation/voting.html