From 0f76bd6fbfaf13e2992929e71f4068f117d35628 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Sat, 27 Apr 2024 20:08:58 -0400 Subject: [PATCH] Docs: Add governance page to contributor guide (#10238) * Docs: Add governance page to contributor guide * Update docs/source/contributor-guide/governance.md Co-authored-by: Liang-Chi Hsieh * Fix bullet points --------- Co-authored-by: Liang-Chi Hsieh --- 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..27ff90eb92c8 --- /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 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. + +- **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