docs: add more information to the reactivity overview (#10522)

Author: runspired

docs-viewer/docs.warp-drive.io/.vitepress/theme/custom.css

@@ -6,6 +6,23 @@ html:not(.dark) .dark-only {
   display: none !important;
 }
 
+.vp-doc figure {
+  margin: 1.5rem 0;
+  text-align: center;
+}
+
+.vp-doc figure img {
+  display: inline-block;
+}
+
+.vp-doc figcaption {
+  margin-top: 0.5rem;
+  font-size: 0.8rem;
+  color: var(--vp-c-text-2);
+  font-style: italic;
+  line-height: 1.4;
+}
+
 .VPSidebarItem .level-1 > .item > p.text {
   font-weight: 600;
   color: var(--vp-c-text-1);

guides/images/signals-diagram-dark.svg

@@ -6,17 +6,23 @@ title: Overview
 
 <img src="../../images/signals.png" style="height: 150px; float: right; margin: 1em; padding: 2em 0 2em 4em; border-left: .05em solid #999999;" title="" alt="">
 
-WarpDrive relies on [signals](https://github.com/tc39/proposal-signals#readme) to enable universal fine-grained reactivity, but where most projects choose a specific signals implementation for consumers to use, WarpDrive allows you to bring your own or use your framework's.
+***Warp*Drive** relies on [signals](https://github.com/tc39/proposal-signals#readme) to enable universal fine-grained reactivity, but where most projects choose a specific signals implementation for consumers to use, ***Warp*Drive** allows you to **bring your own or use your framework's**.
 
-The concept is simple: instead of relying on specifics of signal implementations that may differ, we use signals purely as just that - a signal. The signal itself is never responsible for managing state, storage, or value comparisons.
+The concept is simple: instead of relying on specifics of signal implementations that may differ, **we use signals purely as just that - a signal**. The signal itself is never responsible for managing state, storage, or value comparisons.
 
-Lightweight hooks translate the basic create/consume/notify signal operations into implementation specifics for one (or more) signal libraries.
+Lightweight hooks translate the basic *create/consume/notify* signal operations into implementation specifics for one (or more) signal libraries.
 
-This enables us to be compatible with even the most lightweight and performant signals implementations. The simplicity of this approach keeps WarpDrive relatively future-proof should the spec significantly change or fail to advance. Of course, we hope it becomes a first-class language feature!
+This enables us to be compatible with even the most lightweight and performant signals implementations. The simplicity of this approach keeps ***Warp*Drive** relatively future-proof should the spec significantly change or fail to advance. Of course, we hope it becomes a first-class feature of both the language and web APIs!
 
 Signals are used to alert the reactive consumers to changes in the underlying cache. E.g. a signal is associated to a value, but does
 not serve as the cache for that value directly. We refer to this as
 a "gate", though the pattern has also been referred to as "side-signals".
 
-We find this approach naturally solves many of the concerns and limitations given around various signals implementations, and fits WarpDrive's specific use cases exceedingly well. WarpDrive manages
+<figure>
+  <img class="dark-only" src="../../images/signals-diagram-dark.svg" alt="management of signals in WarpDrive" width="100%">
+  <img class="light-only" src="../../images/signals-diagram-light.svg" alt="management of signals in WarpDrive" width="100%">
+  <figcaption>WarpDrive uses Side Signals</figcaption>
+</figure>
+
+We find this approach naturally solves many of the concerns and limitations given around various signals implementations, and fits ***Warp*Drive**'s specific use cases exceedingly well. ***Warp*Drive** manages
 normalized caches of raw data - usually json - that are typically asynchronously retrieved from latent sources. By separating signal from storage, we can safely perform cache updates even when multiple asynchronous steps are involved to do so, while only notifying consumers when updates are complete.