snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

docs/develop/contribute/good-decisions/fixing-pr-mistakes.md

@@ -0,0 +1,38 @@
+---
+title: "When a merged PR results in a bug"
+sidebar_position: 2
+---
+
+This page describes the process to follow when someone notices a mistake in a merged pull request (PR).
+
+1. A contributor (either staff or community member) submits a PR, it is reviewed and merged into the codebase.
+2. Sometime later, the community notices a mistake with the PR.
+
+Question is, what should we, as a community, do? That depends on the scope of the changes in the PR that was merged.
+
+## Low impact issues
+A low impact PR might mean that it affected:
+- Some non-critical functionality.
+- It doesn't affect users in a substantial way.
+
+If this is the case, do the following:
+
+1. Capture details in an issue.
+2. Mark it according to its priority.
+3. Would be best to assign it to the person who introduced the issue in the first place.
+
+## High impact issues
+A high impact PR represents something that has or will result in a customer incident.
+
+If this is the case, there are two scenarios:
+
+1. The feature introduced in the PR is handled by a feature flag.
+2. The feature introduced in the PR is **not** handled by a feature flag. 
+
+For scenario 1, if it's not affecting other functionality, turn that feature flag off to disable the feature.
+
+For scenario 2:
+
+1. Revert the changes introduced in the original PR.
+2. Notify the person who worked on the PR so they can work on a proper fix for their PR.
+3. Reintroduce the change through the regular PR cycle.

docs/develop/contribute/good-decisions/index.md

@@ -0,0 +1,37 @@
+---
+title: "Community expectations"
+sidebar_position: 2
+---
+We are a welcoming and open community and we’re excited to have you join us!
+
+To be an open, safe, and welcoming community, we strive to be inclusive, collaborative, considerate, and respectful. We all abide by the [Mattermost Code of Conduct (CoC)](https://handbook.mattermost.com/contributors/contributors/guidelines/contribution-guidelines), and by joining our contributor community, **you agree to abide by it as well**.
+
+Learn more about our [company values](https://handbook.mattermost.com/company/about-mattermost#leadership-principles), and how to become a successful member of the Mattermost community by learning and following our standard operational guidelines below. Please read these sections below carefully and let us know if you have any questions or concerns.
+
+## We are inclusive
+
+We welcome all people, **but not all behavior**.
+
+We are a diverse community who celebrate both our differences and the things that connect us. We treat each other with respect, and aim to treat others better than they wish to be treated.
+
+We try our best to be clear and respectful. We remember that others may not communicate in the same language with the same fluency. We recognize that communication can be challenging, especially among a diverse group of people communicating in many different languages and coming from many different cultures and backgrounds.
+
+We all try to be mindful of our differences when we communicate and collaborate. We’re aware that misunderstandings can happen. We try to resolve them by being respectful, understanding, and by using clear and simple language.
+
+## We are collaborative
+  - We ask questions and consult others.
+  - We work together and help each other.
+  - We aim for clarity.
+
+## We are considerate
+  - We have patience with each other.
+  - We understand that no one has all the answers, nor are they expected to.
+
+## We are respectful
+  - We offer thanks and we’re grateful.
+  - We may occasionally disagree, but we resolve these disagreements in respectful ways, take breaks if things get heated, reassess, and consult others where appropriate.
+  - We aim to be self-aware and we take responsibility for our impact through our words and actions.
+  - We understand and acknowledge that [intent doesn’t equal impact](https://www.betterup.com/blog/intent-vs-impact). We can have the best of intentions, but still cause negative impact to others by our words and actions. This can happen to all of us, so we practice openness and grace.
+
+### Attribution
+This document was heavily inspired by and adapted from the work of the [Drupal Community and its Code of Conduct](https://www.drupal.org/dcoc) and its [Values and Principles](https://www.drupal.org/about/values-and-principles) documents.