Docs

user-guide/related-metrics.md

@@ -0,0 +1,30 @@
+# Related metrics
+
+The **Related** helper answers: “Given this chart, what else should I look at?”
+
+It is **client-side** ranking (taxonomy + optional Pearson on loaded series + alert-weight boost). It does **not** replace [Metric Correlations](./metric-correlations.md).
+
+## How to open
+
+- Click **⇢** on a chart card, or  
+- **Double-click** the card (also expands stats)
+
+A panel lists ranked chart ids with short reasons (e.g. same context, high correlation). Click a row to scroll to that card. **Clear** or **Esc** dismisses.
+
+## Scoring (summary)
+
+| Signal | Effect |
+|--------|--------|
+| Same / related context, family, plugin, units | Taxonomy boost |
+| Pearson \|r\| on already-loaded wall series | Series similarity (needs enough points on both cards) |
+| Alert weights (`getWeights` without a highlight window) | Boost currently noisy charts |
+
+Pearson only runs on charts **already fetched** for the wall (visible / nearby). Taxonomy still ranks the full catalog.
+
+## Correlate vs Related
+
+| | Correlate | Related |
+|--|-----------|---------|
+| Question | What **changed** vs baseline? | What is **similar / nearby**? |
+| Where | Toolbar **Correlate** | Card **⇢** |
+| Engine | Server weights (`volume` / `ks2` / …) | Desktop `related-metrics.js` |