Merge branch 'master' of github.com:squidfunk/mkdocs-material

Author: squidfunk

docs/contributing/index.md

@@ -114,7 +114,7 @@ In this section, we guide your through our processes.
   [report a docs issue]: reporting-a-docs-issue.md
   [request a change]: requesting-a-change.md
   [add translations]: https://github.com/squidfunk/mkdocs-material/adding-translations
-  [create a pull request]: https://github.com/squidfunk/mkdocs-material/pulls
+  [create a pull request]: making-a-pull-request.md
 
 ## Checklist
 
@@ -168,35 +168,89 @@ with our community.
 
 ## Rights and responsibilities
 
-As maintainers, we reserve the right and have the responsibility to close,
-remove, reject, or edit contributions, such as issues, discussions, comments,
-or commits, that do not align with our contribution guidelines and our
-[Code of Conduct].
+As maintainers, we are entrusted with the __responsibility__ to moderate
+communication within our community, including the authority to close, remove,
+reject, or edit issues, discussions, comments, commits, and to block users who
+__do not align__ with our contribution guidelines and our [Code of Conduct].
+This role requires us to be actively involved in maintaining the integrity and
+positive atmosphere of our community. Upholding these standards decisively
+ensures a respectful and inclusive environment for all members.
 
-### Incomplete issues
-
-We have invested significant time in reviewing our contribution process and
-carefully assessed the essential requirements when reviewing and responding to
-issues. Each field in our issue templates has been thoughtfully curated, helping
-us to understand your matter.
-
-__Therefore, it is mandatory to fill out every field as requested__ to the best
-of your knowledge. We need all of this information because it ensures that every
-user and maintainer, regardless of their experience, can understand the content
-and severity of your bug report or change request.
-
-__We reserve the right to close issues missing essential information__, such as
-but not limited to [minimal reproductions], or that do not comply with the
-quality standards and requirements stated in our issue templates. Issues
-can be reopened once the missing information has been provided.
-
-  [minimal reproductions]: ../guides/creating-a-reproduction.md
 
 ### Code of Conduct
 
-As stated in our [Code of Conduct], we expect all members of our community to
-treat each other with respect, and use inclusive and welcoming language. We
-always strive to create a positive and supportive environment and do not accept
+Our [Code of Conduct] outlines the expectation for all community members to
+treat one another with respect, employing inclusive and welcoming language. Our
+commitment is to foster a positive and supportive environment, free of
 inappropriate, offensive, or harmful behavior.
 
-We take violations seriously and will take appropriate action in response.
+We take any violations seriously and will take appropriate action in response to
+uphold these values.[^1]
+
+  [^1]:
+    __Warning and blocking policy:__
+    Given the increasing popularity of our project and our commitment to a
+    healthy community, we've defined clear guidelines on how we proceed with
+    violations:
+
+    1.1. __First warning:__ Users displaying repeated inappropriate, offensive,
+    or harmful behavior will receive a first warning. This warning serves as a
+    formal notice that their behavior is not in alignment with our community
+    standards and Code of Conduct. The first warning is permanent.
+
+    1.2. __Second warning and opportunity for resolution:__ If the behavior
+    persists, a second warning will be issued. Upon receiving the second
+    warning, the user will be given a 5-day period for reflection, during which
+    they are encouraged to publicly explain or apologize for their actions.
+    This period is designed to offer an opportunity for openly clearing out any
+    misunderstanding.
+
+    1.3. __Blocking:__ Should there be no response or improvement in behavior
+    following the second warning, we reserve the right to block the user from
+    the community and repository. Blocking is considered a last resort, used
+    only when absolutely necessary to protect the community's integrity and
+    positive atmosphere.
+
+    Blocking has been an exceptionally rare necessity in our overwhelmingly
+    positive community, highlighting our preference for constructive dialogue
+    and mutual respect. It aims to protect our community members and team.
+
+### Incomplete issues and duplicates
+
+We have invested significant time and effort in the setup of our contribution
+process, ensuring that we assess the essential requirements for reviewing and
+responding to issues effectively. Each field in our issue templates is
+thoughtfully designed to help us fully understand your concerns and the nature
+of your matter. We encourage all members to utilize the search function before
+submitting new issues or starting discussions to help avoid duplicates. Your
+cooperation is crucial in keeping our community's discussions constructive and
+organized.
+
+  - __Mandatory completion of issue templates:__ We need all of the information
+  required in our issue templates because it ensures that every user and
+  maintainer, regardless of their experience, can understand the content and
+  severity of your bug report or change request.
+
+  - __Closing incomplete issues:__
+  We _reserve the right to close issues lacking essential information_, such as
+  but not limited to [minimal reproductions] or those not adhering to the
+  quality standards and requirements specified in our issue templates. Such
+  issues can be reopened once the missing information has been provided.
+
+  - __Handling duplicates:__ To maintain organized and efficient
+  communication within our [issue tracker] and [discussion board], we
+  _reserve the right to close any duplicated issues or lock duplicated
+  discussions_. Opening multiple channels to ask the same question or report the
+  same issue across different forums hinders our ability to manage and address
+  community concerns effectively. This approach is vital for efficient time
+  management, as duplicated questions can consume the time of multiple team
+  members simultaneously. Ensuring that each issue or discussion is unique and
+  progresses with new information helps us to maintain focus and support our
+  community.
+
+    We further _reserve the right to immediately close discussions or issues that
+    are reopened without providing new information_ or simply because users have
+    not yet received a response to their issue/question, as the issue is marked as
+    incomplete.
+
+  [minimal reproductions]: ../guides/creating-a-reproduction.md