diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000000..0527a0faf814 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,76 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as +contributors and maintainers pledge to making participation in our project and +our community a harassment-free experience for everyone, regardless of age, body +size, disability, ethnicity, sex characteristics, gender identity and expression, +level of experience, education, socio-economic status, nationality, personal +appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment +include: + +- Using welcoming and inclusive language +- Being respectful of differing viewpoints and experiences +- Gracefully accepting constructive criticism +- Focusing on what is best for the community +- Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +- The use of sexualized language or imagery and unwelcome sexual attention or + advances +- Trolling, insulting/derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or electronic + address, without explicit permission +- Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable +behavior and are expected to take appropriate and fair corrective action in +response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or +reject comments, commits, code, wiki edits, issues, and other contributions +that are not aligned to this Code of Conduct, or to ban temporarily or +permanently any contributor for other behaviors that they deem inappropriate, +threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces +when an individual is representing the project or its community. Examples of +representing a project or community include using an official project e-mail +address, posting via an official social media account, or acting as an appointed +representative at an online or offline event. Representation of a project may be +further defined and clarified by project maintainers. + +## Enforcement + +All complaints will be reviewed and investigated and will result in a response that +is deemed necessary and appropriate to the circumstances. The project team is +obligated to maintain confidentiality with regard to the reporter of an incident. +Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good +faith may face temporary or permanent repercussions as determined by other +members of the project's leadership. + +See [GOVERNANCE.md](GOVERNANCE.md#Moderation) for instructions on reporting a Code of Conduct violation and a full description of the review process. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, +available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html + +[homepage]: https://www.contributor-covenant.org + +For answers to common questions about this code of conduct, see +https://www.contributor-covenant.org/faq \ No newline at end of file diff --git a/COMMUNITY.md b/COMMUNITY.md new file mode 100644 index 000000000000..fae885e50f91 --- /dev/null +++ b/COMMUNITY.md @@ -0,0 +1,16 @@ +# Join the Astro Community + +## Resources + +- [Code of Conduct](CODE_OF_CONDUCT.md) +- [GitHub](https://github.com/snowpackjs/astro) +- [Discord](https://astro.build/chat) + +**All members must follow the [Code of Conduct](CODE_OF_CONDUCT.md).** Consequences for member violations are detailed in [Moderation](GOVERNANCE.md#moderation). + +> **Note:** This document is currently being written, and is not yet binding. Once this note is removed, this document will go into effect. + + +## Get Involved + +TODO \ No newline at end of file diff --git a/GOVERNANCE.md b/GOVERNANCE.md new file mode 100644 index 000000000000..2d2939cbd9c4 --- /dev/null +++ b/GOVERNANCE.md @@ -0,0 +1,172 @@ +> **Note:** Our governance model is extremely new, and is not yet binding. Once merged into the `main` branch, we will go into a trial period where we will follow this governance model but may make changes based on feedback. All changes will go through our existing PR review process. After a period of 1-2 months, this note will be removed and this governance model will become binding. + +# Governance + +This document outlines the governance model for Astro. This includes the contributor model, code review, merging, and the consequences and process for Code of Conduct violations. + +**All members must follow the [Code of Conduct](CODE_OF_CONDUCT.md).** Consequences for member violations are detailed in [Moderation](#moderation). + +## Get Involved + +Anyone can become an Astro Contributor regardless of skill level, experience, or background. All types of contribution are meaningful. Our membership system was designed to reflect this. + +**Anything that supports the Astro community is a contribution to the project.** This includes but is not limited to: + - Submitting (and Merging) a Pull Request + - Filing a Bug Report or Feature Request + - Updating Documentation + - Answering questions about Astro on GitHub or Discord + - Answering questions on Stack Overflow, Twitter, etc. + - Blogging, Podcasting, or Livestreaming about Astro + + +## Membership Levels, Roles and Responsibilities + +A list of all active members is available on our project README. + +### Contributor L1 + +Have you done something to contribute to the health, success, or growth of Astro? Congratulations, you're officially a contributor! + +**Benefits:** +- Contributor status on the [Astro Discord server](https://astro.build/chat) +- Ability to [vote](GOVERNANCE.md#voting) on some project decisions + +**Nomination:** +- Self-nominate by running `!contribute` in our Discord and briefly describe your qualifying contribution (link preferred). +- Connect your Discord account with GitHub (or Reddit, Twitter, etc.) to automatically get recognized for future contributions. + + +### Contributor L2 (Committer) + +**Contributor L2** membership is reserved for users that have shown a commitment to the continued development of the project through ongoing engagement with the community. At this level, contributors are given push access to the project's GitHub repos and must continue to abide by the project's Contribution Guidelines. + +Anyone who has made several significant (non-trivial) contributions to Astro can become a Contributor in recognition of their work. An example of a "significant contribution" might be: +- ✅ Triaging and supporting non-trivial Discord and GitHub issues +- ✅ Submitting and reviewing non-trivial PRs +- ✅ Submitting and reviewing non-trivial documentation edits (multiple sections/pages) +- ❌ A typo fix, or small documentation edits of only a few sentences + +**Responsibilities:** +- May request write access to relevant Astro projects. +- GitHub: May work on public branches of the source repository and submit pull requests from that branch to the main branch. +- GitHub: Must submit pull requests for all changes, and have their work reviewed by other members before acceptance into the repository. +- GitHub: May merge some pull requests (see Managing Pull Requests) + +**Nomination:** +- A nominee will need to show a willingness and ability to participate in the project as a team player. +- Typically, a nominee will need to show that they have an understanding of and alignment with the project, its objectives, and its strategy. +- Nominees are expected to be respectful of every community member and to work collaboratively in the spirit of inclusion. +- Have submitted a minimum of 10 qualifying significant contributions (see list above). +- You can be nominated by any existing Contributor (L2 or above). +- Once nominated, there will be a vote by existing Contributors (L3 or above). + +It is important to recognize that this role is a privilege, not a right. That privilege must be earned and once earned it can be removed (in a vote by project Stewards). However, under normal circumstances this role exists for as long as the Contributor wishes to continue engaging with the project. + +Inactive Contributors will have voting rights removed after a certain period of time, however they will always retain their status. Inactivity requirements will be specified in a later governance change. + + +### Contributor L3 (Core Contributor) + +Contributor L3 (Core Contributors) are community members who have contributed a significant amount of time to the project through triaging of issues, fixing bugs, implementing enhancements/features, and are trusted community leaders. + +**Responsibilities:** +- May merge external pull requests for accepted issues upon reviewing and approving the changes. +- May merge their own pull requests once they have collected the feedback and approvals they deem necessary. + - Caveat: No pull request should be merged without at least one Contributor (L2 or above) comment stating they've looked at the code. + +**Nomination:** +- Work in a helpful and collaborative way with the community. +- Have given good feedback on others' submissions and displayed an overall understanding of the code quality standards for the project. +- Commit to being a part of the community for the long-term. +- Have submitted a minimum of 50 qualifying significant contributions (see list above). + +A Contributor is invited to become a Core Contributor by existing Core Contributors. A nomination will result in discussion and then a decision by the project steward(s). + + +### Steward + +Steward is an additional privilege bestowed to 1 (or more) Contributors. The role of Steward is mainly an administrative one. Stewards control and maintain sensitive project assets, and act as tiebreakers in the event of disagreements. These additional privileges include: + +- Access to the [@astrodotbuild Twitter account](https://twitter.com/astrodotbuild) +- Administration privileges on the [astro GitHub org](https://github.com/snowpackjs) +- Administration privileges on the [astro Discord server](https://astro.build/chat) +- Publish access to the [`astro` npm package](https://www.npmjs.com/package/astro) +- Domain registrar and DNS access to `astro.build` and all other domains +- Administration access to the `astro.build` Vercel account +- Ability to initiate a [vote](GOVERNANCE.md#voting) +- Ability to veto [votes](GOVERNANCE.md#voting) and resolve voting deadlocks +- Define project direction and planning +- Ability to decide on moderation decisions +- Access to the `*@astro.build` email address + +**Nomination:** +- Stewards cannot be self-nominated. +- Only Core Contributors are eligible. +- New stewards will be added based on a unanimous vote by the existing stewards. +- In the event that someone is unreachable then the decision will be deferred. Discussion and approval will be done in private. + +## Voting + +Certain project decisions require a vote. These include: + +- Governance changes: simple majority (over 50%) conducted via GitHub PR approval. +- Core contributor membership: overwhelming majority (over 70%) conducted by privately messaging a steward. Funneling both assenting and dissenting votes directly through stewards allows for anonymity when discussing the merits of a potential contributor. + +A steward may initiate a vote for any unlisted project decision. Core contributors can request a vote by contacting a steward. + +### Rules + +- Members may abstain from a vote. +- Members who do not vote within 3 days will automatically abstain. +- Stewards may reduce the 3 day automatic abstain for urgent decisions. +- Stewards reserve the right to veto approval with a publicly disclosed reason. + + +## Moderation + +Outlined below is the process for Code of Conduct violation reviews. + +### Reporting + +Anyone may report a violation. Violations can be reported in the following ways: + +- In private, via email to one or more stewards. +- In private, via direct message to a project steward on Discord. +- In public, via a GitHub comment (mentioning `@snowpackjs/maintainers`). +- In public, via the project Discord server (mentioning `staff`). + +### Who gets involved? + +Each report will be assigned reviewers. These will initially be all project [stewards](#stewards). + +In the event of any conflict of interest - ie. stewards who are personally connected to a situation, they must immediately recuse themselves. + +At request of the reporter and if deemed appropriate by the reviewers, another neutral third-party may be involved in the review and decision process. + +### Review + +If a report doesn’t contain enough information, the reviewers will strive to obtain all relevant data before acting. + +The reviewers will then review the incident and determine, to the best of their ability: + +- What happened. +- Whether this event constitutes a Code of Conduct violation. +- Who, if anyone, was involved in the violation. +- Whether this is an ongoing situation. + +The reviewers should aim to have a resolution agreed very rapidly; if not agreed within a week, they will inform the parties of the planned date. + +### Resolution + +Responses will be determined by the reviewers on the basis of the information gathered and of the potential consequences. It may include: + +- taking no further action +- issuing a reprimand (private or public) +- asking for an apology (private or public) +- permanent ban from the GitHub org and Discord server +- revoked contributor status + + + +--- +Inspired by [ESLint](https://eslint.org/docs/6.0.0/maintainer-guide/governance) and [Rome](https://github.com/rome/tools/blob/main/GOVERNANCE.md). \ No newline at end of file