Browse Source

Merge pull request #95 from o3de/cleanup

Cleanup nominations and guidelines
chanmosq 2 years ago
parent
commit
099414edf5

+ 8 - 8
.github/ISSUE_TEMPLATE/community-specialist.yaml

@@ -18,7 +18,7 @@ body:
         * Assist in enforcing the [code of conduct](https://lfprojects.org/policies/code-of-conduct/).
         * Assist in enforcing the [code of conduct](https://lfprojects.org/policies/code-of-conduct/).
         * Attending SIG meetings which you can represent the community in is recommended but not required.
         * Attending SIG meetings which you can represent the community in is recommended but not required.
         
         
-        **Maintaing status:** Remain active in community review, project discussions, blog review, or blog submission for a 90 day period.
+        **Maintaining status:** Remain active in community review, project discussions, blog review, or blog submission for a 90 day period.
 
 
         For more on the general requirements of the O3DE community roles, read our
         For more on the general requirements of the O3DE community roles, read our
         [Community Membership](https://github.com/o3de/community/blob/main/community-membership.md) information.
         [Community Membership](https://github.com/o3de/community/blob/main/community-membership.md) information.
@@ -55,10 +55,10 @@ body:
     attributes:
     attributes:
       label: Nomination Review Checklist
       label: Nomination Review Checklist
       description: > 
       description: > 
-      3+ boxes must be checked (Including community member approvals)
-      Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
-      options:
-        - label: 2+ Community Specialists who approve, _or_ 3+ Community members (Reviewer, Maintainer, Chair) who approve
-        - label: Active on GitHub for 90 days
-        - label: Active on O3DE Discord for 90 days
-        - label: Consistent involvement in pull requests, discussions, or community channels for the last 60 days
+        3+ boxes must be checked (Including community member approvals)
+        Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
+        options:
+          - label: 2+ Community Specialists who approve, _or_ 3+ Community members (Reviewer, Maintainer, Chair) who approve
+          - label: Active on GitHub for 90 days
+          - label: Active on O3DE Discord for 90 days
+          - label: Consistent involvement in pull requests, discussions, or community channels for the last 60 days

+ 5 - 5
.github/ISSUE_TEMPLATE/docs-reviewer-nomination.yaml

@@ -44,9 +44,9 @@ body:
       description: Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
       description: Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
       options:
       options:
         - label: |
         - label: |
-          6+ merged documentation contributions for the O3DE project. The following count as documentation contributions:
-          
-          * Contributions to any section of https://o3de.org/docs requiring review by a member of the [sig-docs-community-review](https://github.com/orgs/o3de/teams/sig-docs-community-reviewers) team.
-          * Contributions to accepted sig-docs-community RFCs related to documentation. This may include operational support as well as technical writing.
-          * High-quality error messages, tooltips, UI text, or API documentation submitted to https://github.com/o3de/o3de involving approval of at least one member of the [docs-reviewer](https://github.com/orgs/o3de/teams/docs-reviewers) team.
+            6+ merged documentation contributions for the O3DE project. The following count as documentation contributions:          
+            
+            * Contributions to any section of https://o3de.org/docs requiring review by a member of the [sig-docs-community-review](https://github.com/orgs/o3de/teams/sig-docs-community-reviewers) team.
+            * Contributions to accepted sig-docs-community RFCs related to documentation. This may include operational support as well as technical writing.
+            * High-quality error messages, tooltips, UI text, or API documentation submitted to https://github.com/o3de/o3de involving approval of at least one member of the [docs-reviewer](https://github.com/orgs/o3de/teams/docs-reviewers) team.
         - label: 2+ docs or community reviewers or maintainers of the Documentation and Community SIG approve the nomination.
         - label: 2+ docs or community reviewers or maintainers of the Documentation and Community SIG approve the nomination.

+ 1 - 1
.github/ISSUE_TEMPLATE/maintainer-nomination.yaml

@@ -52,7 +52,7 @@ body:
       label: Nomination Review Checklist
       label: Nomination Review Checklist
       description: Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
       description: Leave this empty. This checklist will be filled in by a sig-docs-community member who is reviewing the nomination.
       options:
       options:
-        - label: Has been a Reviewer for the SIG ([docs-reviewer](https://github.com/orgs/o3de/teams/docs-reviewers), community-reviewer, or website-reviewer) for 2+ months.
+        - label: Has been a Reviewer for the SIG ([docs-reviewer](https://github.com/orgs/o3de/teams/docs-reviewers), [community-specialist](https://github.com/orgs/o3de/teams/community-specialist), or [website-reviewer](https://github.com/orgs/o3de/teams/sig-docs-community-site-reviewers)) for 2+ months.
         - label: 12+ reviewed Pull Requests in the previous 2 months. Under light PR load, has been a reviewer for a minimum of 3 months.
         - label: 12+ reviewed Pull Requests in the previous 2 months. Under light PR load, has been a reviewer for a minimum of 3 months.
         - label: 2+ Documentation and Community SIG Maintainers who support promotion. In the absence of enough maintainers, chairs will promote.
         - label: 2+ Documentation and Community SIG Maintainers who support promotion. In the absence of enough maintainers, chairs will promote.
 
 

+ 6 - 3
governance/reviewers-maintainers.md

@@ -1,15 +1,18 @@
 ## Documentation and Community reviewer roles
 ## Documentation and Community reviewer roles
 
 
-The Documentation and Community SIG maintains the following reviewer teams:
+The Documentation and Community (D&C) SIG maintains the following reviewer teams:
 
 
 * [**Documentation Reviewer**](https://github.com/orgs/o3de/teams/sig-docs-community-reviewers) - Responsible for reviewing documentation content to `o3de.org`, or conducting reviews of certain `o3de` in-product documentation elements.
 * [**Documentation Reviewer**](https://github.com/orgs/o3de/teams/sig-docs-community-reviewers) - Responsible for reviewing documentation content to `o3de.org`, or conducting reviews of certain `o3de` in-product documentation elements.
-* **Community Specialist** - Responsible for helping review community content on [o3de.org](http://www.o3de.org) as well as participate actively in Open 3D Engine community channels.
+* [**Community Specialist**](https://github.com/orgs/o3de/teams/community-specialist) - Responsible for helping review community content on [o3de.org](http://www.o3de.org) as well as participate actively in Open 3D Engine community channels.
+* [**Website Reviewer**](https://github.com/orgs/o3de/teams/sig-docs-community-site-reviewers) - Responsible for reviewing contributions that add layouts, templates, improve functionality, or change the appearance of `o3de.org` in some way.
 
 
 We also have [SIG maintainers](https://github.com/orgs/o3de/teams/sig-docs-community-maintainers). Documentation and Community maintainers are reviewers who have been elevated from the documentation or community reviewer teams to take on additional responsibility and serve as trusted sources of guidance.
 We also have [SIG maintainers](https://github.com/orgs/o3de/teams/sig-docs-community-maintainers). Documentation and Community maintainers are reviewers who have been elevated from the documentation or community reviewer teams to take on additional responsibility and serve as trusted sources of guidance.
 
 
+To nominate yourself or a peer for a reviewer role, [create an issue](https://github.com/o3de/sig-docs-community/issues/new/choose) using the appropriate issue template.
+
 ### Technical reviewer roles
 ### Technical reviewer roles
 
 
-The Documentation and Community SIG also maintains a documentation technical reviewer team for the `o3de.org` website and its related infrastructure. Documentation technical reviewers are responsible for representing their SIG during documentation review, and ensuring technical accuracy of content.
+Although O3DE Documentation is primarily supported by D&C SIG, it's also significantly supported by technical reviewers from other SIGs. Technical reviewers have a critical role of verifying the technical accuracy of documentation. They are managed separately by their corresponding SIG as part of their SIG's reviewer or maintainer team. For more information about being a reviewer from other SIGs, refer to [Becoming a Reviewer or Maintainer](https://github.com/o3de/community/blob/main/community-membership.md).
 
 
 ### Open 3D Engine Community Roles
 ### Open 3D Engine Community Roles