diff --git a/doc/source/jobs.rst b/doc/source/jobs.rst
index f1f457a1a..6d0be30e7 100644
--- a/doc/source/jobs.rst
+++ b/doc/source/jobs.rst
@@ -48,10 +48,15 @@ Jobboards
 High level architecture
 =======================
 
-.. image:: img/jobboard.png
+.. figure:: img/jobboard.png
    :height: 350px
    :align: right
 
+   **Note:** This diagram shows the high-level diagram (and further
+   parts of this documentation also refer to it as well) of the zookeeper
+   implementation (other implementations will typically have
+   different architectures).
+
 Features
 ========