Docs

docs/DESKTOP.md

@@ -14,6 +14,7 @@ The client shell is a **Pear desktop application** built with `pear-electron` +
 | `ui/styles.css` | Layout, theme, **titlebar drag regions** |
 | `client/*` | HyperDHT connection stack used by the UI |
 | `docs/DASHBOARD.md` | Master Charts / metrics wall plan |
+| `user-guide/` | End-user workflows (Correlate, Related, Fleet, …) |
 
 ```bash
 npm start          # pear run -d .
@@ -188,8 +189,19 @@ Override root with `PEARDATA_HOME`. Writes are atomic (`tmp` → rename, mode `0
 
 This template ships the **Pear run** path only. For Electron-forge / multi-arch standalone binaries, adapt packaging from a fuller product (e.g. peardock’s forge + bare-standalone scripts) once the app stabilizes.
 
+## Charts investigation (summary)
+
+| Control | Doc |
+|---------|-----|
+| Metrics wall, time, board, gestures | [user-guide/charts.md](../user-guide/charts.md) · [DASHBOARD.md](./DASHBOARD.md) |
+| **Correlate** (highlight → Find Correlations) | [user-guide/metric-correlations.md](../user-guide/metric-correlations.md) |
+| **Related (⇢)** (taxonomy + Pearson) | [user-guide/related-metrics.md](../user-guide/related-metrics.md) |
+
+Implementation: `ui/dashboard.js`, `server/services/weights.js`, `shared/related-metrics.js`.
+
 ## Related
 
+- [User guide](../user-guide/README.md)
 - [GETTING-STARTED.md](./GETTING-STARTED.md)
 - [ARCHITECTURE.md](./ARCHITECTURE.md)
 - [CONFIGURATION.md](./CONFIGURATION.md)