From 75f69ee2eee9aa94aa4639fbf8a0b5a4dd1ba0a7 Mon Sep 17 00:00:00 2001
From: MarcoIeni <11428655+MarcoIeni@users.noreply.github.com>
Date: Thu, 4 Jun 2026 10:03:05 +0200
Subject: [PATCH] document configured external runners

---
 src/SUMMARY.md                        |  1 +
 src/infra/docs/external-ci-runners.md | 34 +++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 src/infra/docs/external-ci-runners.md

diff --git a/src/SUMMARY.md b/src/SUMMARY.md
index 705d25d4e..f74fd6362 100644
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@@ -106,6 +106,7 @@
         - [CDN](./infra/docs/cdn.md)
         - [Crater agents](./infra/docs/crater-agents.md)
         - [Dev Desktops](./infra/docs/dev-desktop.md)
+        - [External CI Runners](./infra/docs/external-ci-runners.md)
         - [GitHub App for dev-desktops](./infra/docs/dev-desktop-github-app.md)
         - [Domain names and DNS](./infra/docs/dns.md)
         - [docs.rs](./infra/docs/docs-rs.md)
diff --git a/src/infra/docs/external-ci-runners.md b/src/infra/docs/external-ci-runners.md
new file mode 100644
index 000000000..b6689c2d2
--- /dev/null
+++ b/src/infra/docs/external-ci-runners.md
@@ -0,0 +1,34 @@
+# External CI Runners
+
+The Rust Project mainly runs Continuous Integration (CI) in GitHub Actions.
+When GitHub Actions does not natively support a target, we use
+[self-hosted runners](https://docs.github.com/en/actions/concepts/runners/self-hosted-runners).
+
+## Configured external CI runners
+
+This section lists the external CI runners that are configured to run in the CI of the Rust Project.
+
+Here is an explanation of the fields in the list below:
+
+- `max concurrency`: The available number of runners of this type.
+  This determines the maximum number of GitHub Actions jobs that can run on the runner.
+  The concurrency is shared among repositories. If all runners are busy, GitHub Actions will queue
+  the jobs until a runner is available.
+- `repositories`: The repositories that are enabled to use the runner. To add your repository to the
+  list, please open a PR to this file.
+  Make sure the workflow you want to run the runner on passes [`zizmor`](https://zizmor.sh/).
+- `contact`: The contact information of the person(s) responsible for maintaining the runner.
+  The recommended way to contact them is via Zulip, by opening a new topic in the
+  [#t-infra](https://rust-lang.zulipchat.com/#narrow/channel/242791-t-infra) channel and mentioning
+  the contact person(s).
+
+### `powerpc64-unknown-linux-musl`
+
+- max concurrency: 4
+- repositories:
+  - [`compiler-builtins`](https://github.com/rust-lang/compiler-builtins)
+  - [`libc`](https://github.com/rust-lang/libc)
+- [example workflow](https://github.com/rust-lang/compiler-builtins/pull/1219)
+- contact:
+  - Zulip: [Aelin](https://rust-lang.zulipchat.com/#user/338253)
+  - Email: `aelin@postmarketos.org` (faster response)