diff --git a/docs/diagram.md b/docs/diagram.md
index 2238bf46..139970d4 100644
--- a/docs/diagram.md
+++ b/docs/diagram.md
@@ -59,6 +59,18 @@ As this one:
 ![OrderControl](images/order_control_machine_initial.png)
 
 
+If you find the resolution of the image lacking, you can
+
+```py
+>>> dot.set_dpi(300)
+
+>>> dot.write_png("docs/images/order_control_machine_initial_300dpi.png")
+
+```
+
+![OrderControl](images/order_control_machine_initial_300dpi.png)
+
+
 The current {ref}`state` is also highlighted:
 
 ``` py
diff --git a/docs/images/order_control_machine_initial_300dpi.png b/docs/images/order_control_machine_initial_300dpi.png
new file mode 100644
index 00000000..4e6136dc
Binary files /dev/null and b/docs/images/order_control_machine_initial_300dpi.png differ