summaryrefslogtreecommitdiff
path: root/github-management
diff options
context:
space:
mode:
authorChristoph Blecker <admin@toph.ca>2018-07-18 15:06:08 -0700
committerChristoph Blecker <admin@toph.ca>2018-07-18 15:06:08 -0700
commit8adb7c849a02336ced34c8613008358ccc68a103 (patch)
treedc9323f169a7d12726311d1f0dcddbd9db537a1d /github-management
parenta6baaf20185d39737bd83d886f564054e0c3b41c (diff)
Establish GitHub Management Subproject
Diffstat (limited to 'github-management')
-rw-r--r--github-management/OWNERS7
-rw-r--r--github-management/README.md4
-rw-r--r--github-management/subproject-responsibilites.md27
3 files changed, 38 insertions, 0 deletions
diff --git a/github-management/OWNERS b/github-management/OWNERS
new file mode 100644
index 00000000..70807ad1
--- /dev/null
+++ b/github-management/OWNERS
@@ -0,0 +1,7 @@
+reviewers:
+ - cblecker
+approvers:
+ - cblecker
+labels:
+ - sig/contributor-experience
+ - area/github-management
diff --git a/github-management/README.md b/github-management/README.md
index 9284fe78..a15b7a66 100644
--- a/github-management/README.md
+++ b/github-management/README.md
@@ -9,6 +9,10 @@ policies to reduce friction and ease administration of our Github repositories
and organizations. We have also created a number of tools to automate setup and
enforcement of these policies.
+These polices are overseen by the
+[GitHub Management subproject](subproject-responsibilites.md) of the Contributor
+Experience Special Interest Group.
+
## Guides
- [Organization Owners Guide](org-owners-guide.md)
- [Repository Creation Guidelines](kubernetes-repositories.md)
diff --git a/github-management/subproject-responsibilites.md b/github-management/subproject-responsibilites.md
new file mode 100644
index 00000000..a3aa7fd1
--- /dev/null
+++ b/github-management/subproject-responsibilites.md
@@ -0,0 +1,27 @@
+# GitHub Management Subproject Responsibilities
+
+This subproject will be responsible for:
+- Establishing policies, standards, and procedures for routine GitHub management
+ tasks, including but not limited to: org membership, org permissions, repo
+ creation/administration
+- Establishing a policy around "Org Owner" permissions, and grant/limit these
+ privileges accordingly
+- Establishing policies and best practices for bot accounts, service accounts,
+ webooks, and third-party integrations
+- Maintaining documentation related to the above
+- Establishing a "GitHub Administration team" that will oversee the execution of
+ GitHub management tasks (inviting new members to the org, creating repos,
+ executing moderation decisions, auditing permissions)
+- Working with other sigs and interested parties in the project to execute
+ GitHub tasks where required
+
+This subproject will explicitly not be responsible for:
+- Tooling and automation for GitHub (this falls under sig-testing, and the
+ sig-contributor-experience Contributor Workflow and Automation subproject)
+- Determining policies around which repos can get created (this falls under
+ sig-architecture and the steering committee)
+- Moderation policies and escalations on GitHub (this falls under the Moderation
+ subproject, the Code of Conduct committee, and the steering committee)
+- Contributor workflow within Kubernetes repos, e.g. mandated use of labels
+ (this falls under the guise of the subproject responsible for the repo, and
+ the Contributor Workflow and Automation subproject)