diff --git a/docs/shared/core-features/distribute-task-execution.md b/docs/shared/core-features/distribute-task-execution.md
index ebc4ef431d..2a7d639f85 100644
--- a/docs/shared/core-features/distribute-task-execution.md
+++ b/docs/shared/core-features/distribute-task-execution.md
@@ -38,10 +38,12 @@ The `--ci` flag can be `github`, `circleci` or `azure`. For more details on sett
Distributed task execution can work on any CI provider. You are responsible for launching jobs in your CI system. Nx Cloud then coordinates the way those jobs work together. There are two different kinds of jobs that you'll need to create in your CI system.
-1. One main job that controls what is going to be executed
+1. One main job (CI) that controls what is going to be executed
2. Multiple agent jobs that actually execute the tasks
-The main job execution flow looks like this:
+
+
+The main CI job execution flow looks like this:
```yaml
# Coordinate the agents to run the tasks
diff --git a/docs/shared/core-features/share-your-cache.md b/docs/shared/core-features/share-your-cache.md
index 40e20194ff..ad3cfb6248 100644
--- a/docs/shared/core-features/share-your-cache.md
+++ b/docs/shared/core-features/share-your-cache.md
@@ -5,6 +5,10 @@ of the cache or use Nx Cloud. Nx Cloud is an app that provides a fast and zero-c
caching. It's completely free for OSS projects and for most closed-sourced
projects ([read more here](https://dev.to/nrwl/more-time-saved-for-free-with-nx-cloud-4a2j)).
+
+
+In this diagram, Teika runs the build once on his machine, then CI, Kimiko and James can use the cached artifact from Teika instead of re-executing the same work.
+
You can connect your workspace to Nx Cloud by running:
```shell
diff --git a/docs/shared/images/dte/distributed-caching-and-task-execution.svg b/docs/shared/images/dte/distributed-caching-and-task-execution.svg
new file mode 100644
index 0000000000..5523806c43
--- /dev/null
+++ b/docs/shared/images/dte/distributed-caching-and-task-execution.svg
@@ -0,0 +1,127 @@
+
diff --git a/docs/shared/images/dte/distributed-caching.svg b/docs/shared/images/dte/distributed-caching.svg
new file mode 100644
index 0000000000..1787ff8e52
--- /dev/null
+++ b/docs/shared/images/dte/distributed-caching.svg
@@ -0,0 +1,96 @@
+