diff --git a/zuul.d/jobs.yaml b/zuul.d/jobs.yaml
index 26bc4e6..b3f6cbc 100644
--- a/zuul.d/jobs.yaml
+++ b/zuul.d/jobs.yaml
@@ -3,4 +3,4 @@
     pre-run: playbooks/web-ext-lint/pre.yaml
     run: playbooks/web-ext-lint/run.yaml
     post-run: playbooks/web-ext-lint/post.yaml
-    description: Check a Web Extension project for basic lint problems.
+    description: ".. include:: ../playbooks/web-ext-lint/README.rst"
diff --git a/zuul.d/test-jobs.yaml b/zuul.d/test-jobs.yaml
index 4221995..33ca91b 100644
--- a/zuul.d/test-jobs.yaml
+++ b/zuul.d/test-jobs.yaml
@@ -2,24 +2,28 @@
 
 - job:
     name: test-ensure-web-ext
+    description: Test the ensure-web-ext role
     run: playbooks/test-ensure-web-ext.yaml
     files:
       - roles/ensure-web-ext/.*
 
 - job:
     name: test-install-build-essential
+    description: Test the install-build-essential role
     run: playbooks/test-install-build-essential.yaml
     files:
       - roles/install-build-essential/.*
 
 - job:
     name: test-ensure-genmanifest
+    description: Test the ensure-genmanifest role
     run: playbooks/test-ensure-genmanifest.yaml
     files:
       - roles/ensure-genmanifest/.*
 
 - job:
     name: test-ensure-cws-upload
+    description: Test the ensure-cws-upload role
     run: playbooks/test-ensure-cws-upload.yaml
     files:
       - roles/ensure-cws-upload/.*