diff --git a/.github/workflows/smoke.yaml b/.github/workflows/smoke.yaml
index 77a3f6ebf2..83885d63c6 100644
--- a/.github/workflows/smoke.yaml
+++ b/.github/workflows/smoke.yaml
@@ -1,3 +1,6 @@
+# Smoke test across OSs: build a Docsy-based site from scratch, fetching Docsy
+# via NPM.
+
 name: smoke
 
 on:
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
index 5205b31d93..13ad7b8098 100644
--- a/.github/workflows/test.yaml
+++ b/.github/workflows/test.yaml
@@ -1,3 +1,6 @@
+# Runs `npm test` to build Docsy & the User Guide and run all repo checks across
+# OSs.
+
 name: test
 
 on: