diff --git a/doc/source/jobs.rst b/doc/source/jobs.rst
index dbbc6c7f6..b8d5c705e 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
 ========