nannou-org · mvklingeren · Jul 25, 2022 · Jul 25, 2022 · Jul 25, 2022 · Jul 25, 2022
diff --git a/guide/src/developer_reference.md b/guide/src/developer_reference.md
@@ -1,6 +1,19 @@
 # Developer Reference
 
-**TODO:** A guide to the architecture of Nannou's internals to help onboard new
-developers. Describes the layout of modules, how to navigate the reference, the
-scope of the main nannou crate i.e. the kinds of work that should go inside the
-main repo and the kinds that might be better off in separate repos, etc.
+The following diagrams are made to visualize the architecture of Nannou. These are created using the C4 diagram standard (see: https://www.c4model.com) with Graphor (see: https://gaphor.org), for which the source is included in (./diagrams/nannou.gaphor).
+
+## Assistive tooling
+While developing with Nannou, the following tooling is available:
+#tooling_component_diagram.png
+![tooling_component_diagram](./diagrams/tooling_component_diagram.png)
+
+## Architecture
+It all starts with the creative artist deciding what to create:
+#developer_context.png  
+![developer_context](./diagrams/developer_context.png)      
+
+#container_diagram.png  
+![container_diagram](./diagrams/container_diagram.png)      
+
+#application_component_diagram.png  
+![application_component_diagram](./diagrams/application_component_diagram.png)    
diff --git a/guide/src/diagrams/application_component_diagram.png b/guide/src/diagrams/application_component_diagram.png
diff --git a/guide/src/diagrams/container_diagram.png b/guide/src/diagrams/container_diagram.png
diff --git a/guide/src/diagrams/developer_context.png b/guide/src/diagrams/developer_context.png