diff --git a/README.md b/README.md
index 98b351f0e..521393d4d 100644
--- a/README.md
+++ b/README.md
@@ -113,3 +113,8 @@ uds run test-single-layer --set LAYER=identity-authorization
```
Note you can specify the `--set FLAVOR=registry1` flag to test using Iron Bank images instead of the upstream images.
+
+## UDS Core Architecture Overview
+
+
+Diagrams are located in `/docs/.images`. See the [diagram README](./docs/.images/README.md) for an explanation and help customizing.
diff --git a/docs/.images/README.md b/docs/.images/README.md
new file mode 100644
index 000000000..62a2ca174
--- /dev/null
+++ b/docs/.images/README.md
@@ -0,0 +1,22 @@
+# UDS Core Diagrams
+
+## Diagram Explanations
+At this time there are three layers to our diagram that visually explain the following:
+
+1. `Overview`, basic view of what applications are present and what other services/applications they are communicating with.
+
+2. `Traffic Direction`, similar to `Overview` layer with the addition of directional arrows to represent the flow of traffic in cluster.
+
+3. `Ports and Protocols`, similar to `Traffic Direction` layer with the addition of ports and protocols.
+
+## How to Customize
+To customize the diagram, download the svg and in [draw.io](https://draw.io) create a new diagram and load in the svg.
+
+To download the [svg from github](https://github.com/defenseunicorns/uds-core/tree/main/docs/.images), select one of the svg files, then select the download button in the top right of the `Preview` view.
+
+Alternatively you can also download the svg from the [uds.defenseunicorns.com](https://uds.defenseunicorns.com/reference/uds-core/overview/) docsite by right clicking and selecting the `Save image as` option.
+
+It doesn't matter which svg you download, they all contain the metadata for the other layers mentioned above (you may need to enable the layers pop up in [draw.io](https://draw.io) to change your layer).
+
+
+#### If you have suggestions for the diagrams, we welcome issues or pull requests contributions to [uds-core](https://github.com/defenseunicorns/uds-core).
diff --git a/docs/.images/uds-core-arch-ingress-egress.svg b/docs/.images/uds-core-arch-ingress-egress.svg
index e6de03bed..921851c6d 100644
--- a/docs/.images/uds-core-arch-ingress-egress.svg
+++ b/docs/.images/uds-core-arch-ingress-egress.svg
@@ -1,4 +1,3 @@
-
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/.images/uds-core-arch-overview.svg b/docs/.images/uds-core-arch-overview.svg
index ae71a237d..a57fe7ffa 100644
--- a/docs/.images/uds-core-arch-overview.svg
+++ b/docs/.images/uds-core-arch-overview.svg
@@ -1,4 +1,3 @@
-
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/.images/uds-core-arch-ports-protocols.svg b/docs/.images/uds-core-arch-ports-protocols.svg
index 69b3e41b1..318acb3fa 100644
--- a/docs/.images/uds-core-arch-ports-protocols.svg
+++ b/docs/.images/uds-core-arch-ports-protocols.svg
@@ -1,4 +1,3 @@
-
-
\ No newline at end of file
+
\ No newline at end of file