summaryrefslogtreecommitdiff
path: root/github-management
diff options
context:
space:
mode:
authork8s-ci-robot <k8s-ci-robot@users.noreply.github.com>2018-07-23 14:21:20 -0700
committerGitHub <noreply@github.com>2018-07-23 14:21:20 -0700
commit3938ea9530e4f903747d2609f37777c8171a9b2e (patch)
tree518e2896fa668278592133f5f081057699db2553 /github-management
parentb5ab8a92de933c42039659782a838a039666883f (diff)
parent8adb7c849a02336ced34c8613008358ccc68a103 (diff)
Merge pull request #2388 from cblecker/github-subproj
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)