Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Add governance page to contributor guide #10238

Merged
merged 4 commits into from
Apr 28, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions docs/source/contributor-guide/governance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
<!---
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->

# Governance

The current PMC and committers are listed in the [Apache Phonebook].
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Rather than list the current list of committers and PMC members and their affiliations, I propose linking to the ASF list


[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
Copy link
Member

Choose a reason for hiding this comment

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

I think these two list items are redundant.
e23123e_capture

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Excellent catch @jonahgao -- fixed in e9a93dd

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
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This section is largely modeled after the arrow page with the same content


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 [email protected] mailing
list.

[code of conduct]: https://www.apache.org/foundation/policies/conduct.html

## Becoming a PMC Member
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I added this section too as I feel like we owe the community some idea of how this works


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.
1 change: 1 addition & 0 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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