diff --git a/roles/write-root-marker/README.rst b/roles/write-root-marker/README.rst
new file mode 100644
index 00000000..f28f7d13
--- /dev/null
+++ b/roles/write-root-marker/README.rst
@@ -0,0 +1,9 @@
+Write the root marker for an AFS publishing job
+
+** Role Variables **
+
+.. zuul:rolevar:: root_marker_dir
+   :default: src/{{ zuul.project.canonical_name }}/doc/build/html
+
+   The documentation build directory.  The marker file will be placed
+   in this directory.
diff --git a/roles/write-root-marker/defaults/main.yaml b/roles/write-root-marker/defaults/main.yaml
new file mode 100644
index 00000000..2fd52fba
--- /dev/null
+++ b/roles/write-root-marker/defaults/main.yaml
@@ -0,0 +1 @@
+root_marker_dir: "src/{{ zuul.project.canonical_name }}/doc/build/html"
diff --git a/roles/write-root-marker/tasks/main.yaml b/roles/write-root-marker/tasks/main.yaml
new file mode 100644
index 00000000..2f7b6cbe
--- /dev/null
+++ b/roles/write-root-marker/tasks/main.yaml
@@ -0,0 +1,4 @@
+- name: Write marker text
+  copy:
+    dest: "{{ root_marker_dir }}/.root-marker"
+    content: "Project: {{ zuul.project.name }} Branch: {{ zuul.branch }} Build: {{ zuul.build }} Revision: {{ zuul.ref }}"