diff --git a/docs/source/pages/developers_guide/index.rst b/docs/source/pages/developers_guide/index.rst
index eb56d1e6b..084e86b0d 100644
--- a/docs/source/pages/developers_guide/index.rst
+++ b/docs/source/pages/developers_guide/index.rst
@@ -231,3 +231,18 @@ some examples.
style_guide
apidoc/index
+
+-----------------------------
+Updating the database diagram
+-----------------------------
+
+Macaron uses a visual representation of its database to better help developers understand the relationships between the tables within it.
+This diagram is created using the `eralchemy2 `_ an entity relation diagrams generator Python library.
+When modifications have been made to Macaron's database, the representative diagram needs to be regenerated to match.
+This can be done using the following command:
+
+.. code-block:: bash
+
+ eralchemy2 -i 'sqlite:////macaron.db' -o er-diagram.svg
+
+Where ```` is the location of Macaron's output folder. The resulting diagram can then replace the previous version found at ``docs/source/assets/er-diagram.svg``