diff --git a/README.md b/README.md
index 50e5c6d..e245e31 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,29 @@ We track project progress using a [Waffle Board](https://waffle.io/datatogether/
** **
-
+| Frontend Services |
+|:---|
+|  [**webapp**](https://github.com/datatogether/webapp) _allows users to add content metadata about crawled resources_ |
+|  [**website**](https://github.com/datatogether/website) _static-generated website to introduce the Data Together project, built with Hugo_ |
+
+| Backend Services | Packages |
+|----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|
+|  [**api**](https://github.com/datatogether/api) |  [**archive**](https://github.com/datatogether/archive) |
+|  [**content**](https://github.com/datatogether/content) |  [**archivertools**](https://github.com/datatogether/archivertools) |
+|  [**coverage**](https://github.com/datatogether/coverage) |  [**cdxj**](https://github.com/datatogether/cdxj) |
+|  [**identity**](https://github.com/datatogether/identity) |  [**config**](https://github.com/datatogether/config) |
+|  [**patchbay**](https://github.com/datatogether/patchbay) |  [**core**](https://github.com/datatogether/core) |
+|  [**sentry**](https://github.com/datatogether/sentry) |  [**dt**](https://github.com/datatogether/dt) |
+|  [**task_mgmt**](https://github.com/datatogether/task_mgmt) |  [**extract_href**](https://github.com/datatogether/extract_href) |
+| |  [**ffi**](https://github.com/datatogether/ffi) |
+| **External Services** |  [**linked_data**](https://github.com/datatogether/linked_data) |
+|  [**ipfs**](https://github.com/ipfs/go-ipfs) |  [**pdf**](https://github.com/datatogether/pdf) |
+|  [**postgres**](https://github.com/postgres/postgres) |  [**resources**](https://github.com/datatogether/resources) |
+|  [**rabbitmq**](https://github.com/rabbitmq/rabbitmq-server) |  [**rewrite**](https://github.com/datatogether/rewrite) |
+|  [**redis**](https://github.com/antirez/redis) |  [**sql_datastore**](https://github.com/datatogether/sql_datastore) |
+| |  [**sql_util**](https://github.com/datatogether/sql_util) |
+| |  [**warc**](https://github.com/datatogether/warc) |
+| |  [**xmp**](https://github.com/datatogether/xmp) |
** **
## What's a service?
@@ -53,29 +75,3 @@ We use [kubernetes](https://kubernetes.io) in production to orchestrate containe
The best way to get data together running locally is to clone the [context repo](https://github.com/datatogether/context) and use `docker-compose` to spin up all the necessary backend services. `docker-compose up` will download all the necessary data together images in a single terminal, hook them together via networking, and will spin up a dev version of the webapp to interact with the platform. Many other services come with `docker-compose.yml` files that outline the miniumum number of other services needed to make a sensible working version of the host service.
-
-** **
-## Repo Links
-Each repository should carry with it its own roadmap, defined by milestones. Check each repo's `README.md` for details
-
-* [**api**](https://github.com/datatogether/api)
-* [**archive**](https://github.com/datatogether/archive)
-* [**archivertools**](https://github.com/datatogether/archivertools)
-* [**cdxj**](https://github.com/datatogether/cdxj)
-* [**config**](https://github.com/datatogether/config)
-* [**content**](https://github.com/datatogether/content)
-* [**coverage**](https://github.com/datatogether/coverage)
-* [**extract_href**](https://github.com/datatogether/extract_href)
-* [**ffi**](https://github.com/datatogether/ffi)
-* [**identity**](https://github.com/datatogether/identity)
-* [**ipfs**](https://github.com/ipfs/go-ipfs)
-* [**linked_data**](https://github.com/datatogether/linked_data)
-* [**patchbay**](https://github.com/datatogether/patchbay)
-* [**postgres**](https://github.com/postgres/postgres)
-* [**rabbitmq**](https://github.com/rabbitmq/rabbitmq-server)
-* [**redis**](https://github.com/antirez/redis)
-* [**sentry**](https://github.com/datatogether/sentry)
-* [**sql_datastore**](https://github.com/datatogether/sql_datastore)
-* [**sql_util**](https://github.com/datatogether/sql_util)
-* [**task-mgmt**](https://github.com/datatogether/mgmt)
-* [**warc**](https://github.com/datatogether/warc)
diff --git a/diagrams/icon_frontend.svg b/diagrams/icon_frontend.svg
new file mode 100644
index 0000000..84307cd
--- /dev/null
+++ b/diagrams/icon_frontend.svg
@@ -0,0 +1,145 @@
+
+
+
+
diff --git a/diagrams/icon_package.svg b/diagrams/icon_package.svg
new file mode 100644
index 0000000..a8f7364
--- /dev/null
+++ b/diagrams/icon_package.svg
@@ -0,0 +1,26 @@
+
+
+
+
diff --git a/diagrams/icon_service.svg b/diagrams/icon_service.svg
new file mode 100644
index 0000000..a0f283d
--- /dev/null
+++ b/diagrams/icon_service.svg
@@ -0,0 +1,56 @@
+
+
+
+
diff --git a/diagrams/service-overview.png b/diagrams/service-overview.png
deleted file mode 100644
index 9a04cdb..0000000
Binary files a/diagrams/service-overview.png and /dev/null differ
diff --git a/diagrams/services-list.png b/diagrams/services-list.png
deleted file mode 100644
index c244fbc..0000000
Binary files a/diagrams/services-list.png and /dev/null differ