From 847502112dd0585f9ac0c4168e403b9e46d0cb41 Mon Sep 17 00:00:00 2001 From: Tom Stellard Date: Mon, 31 Mar 2025 16:08:17 -0700 Subject: [PATCH 1/3] 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 `_ +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 `_. +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 `_ +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. From 100e686e89a14702fb2d07c00c7f625edd6cafe5 Mon Sep 17 00:00:00 2001 From: Tom Stellard Date: Wed, 10 Sep 2025 20:24:11 -0700 Subject: [PATCH 2/3] Fix formatting --- llvm/docs/AdminTasks.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/llvm/docs/AdminTasks.rst b/llvm/docs/AdminTasks.rst index 5a2c6f3dec5da..6258a4379ef68 100644 --- a/llvm/docs/AdminTasks.rst +++ b/llvm/docs/AdminTasks.rst @@ -8,8 +8,8 @@ Commit Access Review * Frequency: Monthly * Permissions: Triage * Description: The `Commit Access Review `_ -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. + 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 `_. @@ -21,8 +21,8 @@ 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. + 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 ---------------------- @@ -30,7 +30,7 @@ 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. + 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 @@ -42,7 +42,7 @@ 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 `_ -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. + 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 `_ + 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. From 4171efe486e1eb0e59af9ffeadc4977755354e01 Mon Sep 17 00:00:00 2001 From: Tom Stellard Date: Wed, 10 Sep 2025 20:32:31 -0700 Subject: [PATCH 3/3] Fix warning --- llvm/docs/UserGuides.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/llvm/docs/UserGuides.rst b/llvm/docs/UserGuides.rst index 19f199fb462e7..0551c8b60a62d 100644 --- a/llvm/docs/UserGuides.rst +++ b/llvm/docs/UserGuides.rst @@ -14,6 +14,7 @@ intermediate LLVM representation. AArch64SME AddingConstrainedIntrinsics + AdminTasks AdvancedBuilds AliasAnalysis AMDGPUUsage