[llvm] Document some of the regular admin tasks (PR #133825)
Tom Stellard via llvm-commits
llvm-commits at lists.llvm.org
Mon Mar 31 16:42:49 PDT 2025
https://github.com/tstellar created https://github.com/llvm/llvm-project/pull/133825
This is not everything, but it's a start.
>From 847502112dd0585f9ac0c4168e403b9e46d0cb41 Mon Sep 17 00:00:00 2001
From: Tom Stellard <tstellar at redhat.com>
Date: Mon, 31 Mar 2025 16:08:17 -0700
Subject: [PATCH] Document some of the regular admin tasks
This is not everything, but it's a start.
---
llvm/docs/AdminTasks.rst | 48 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 48 insertions(+)
create mode 100644 llvm/docs/AdminTasks.rst
diff --git a/llvm/docs/AdminTasks.rst b/llvm/docs/AdminTasks.rst
new file mode 100644
index 0000000000000..5a2c6f3dec5da
--- /dev/null
+++ b/llvm/docs/AdminTasks.rst
@@ -0,0 +1,48 @@
+================
+LLVM Admin Tasks
+================
+
+Commit Access Review
+--------------------
+
+* Frequency: Monthly
+* Permissions: Triage
+* Description: The `Commit Access Review <https://github.com/llvm/llvm-project/actions/workflows/commit-access-review.yml>`_
+github actions job runs once per month and generates an artifact called 'triagers' which is a list of GitHub users who
+no longer qualify for commit access due to limited activity over the last 12 months.
+
+When the job completes, an admin should download the triagers artifact and create an issue asking everyone on
+the list if they still need commit access. Here is an `example issue <https://github.com/llvm/llvm-project/issues/131262>`_.
+The issue should have the 'infra:commit-access' label and should use the same description as the example issue.
+
+Removing Users from LLVM Committers team
+----------------------------------------
+
+* Frequencey: Monthly
+* Permissions: Admin
+* Description: Each month an admin should review any open issues with the infra:commit-access label.
+For any issue that has been open for more than 4 weeks, any user who has not responded on the ticket
+should be moved from the LLVM Committers team to the LLVM Triagers team.
+
+Action Secret Rotation
+----------------------
+
+* Frequency: Monthly
+* Permissions: Admin
+* Description: Each month an admin should rotate the secrets that are used for GitHub Actions workflows
+in the llvm-project repository.
+
+The secrets are personal access tokens that are associated with the llvmbot GitHub account. An admin
+should log in to the llvmbot account, re-generate the personal access tokens and then copy the
+new values into the corresponding secret in the llvm-project repo's settings.
+
+Grant Commit Access
+--------------------
+
+* Frequency: Ongoing
+* Permissions: Admin
+* Description: An admin should periodically review the list of commit access requests. This can be
+done by searching for issues in the llvm-project repository which have the infra:commit-access-request
+label. Any user that meets the `commit access requirements <https://llvm.org/docs/DeveloperPolicy.html#obtaining-commit-access>`_
+should be added to the 'LLVM Committers' team. The admin should add a comment to the issue when
+an invite to join the team has been sent and then close the issue when the invite has been accepted.
More information about the llvm-commits
mailing list