diff --git a/docs/scheduler/jobq.md b/docs/scheduler/jobq.md
index 103b8aa2..9035f987 100644
--- a/docs/scheduler/jobq.md
+++ b/docs/scheduler/jobq.md
@@ -47,6 +47,10 @@ side by side). A step shows one of:
 | `⊘`   | cancelled                                               |
 | `·`   | skipped (not needed for this run)                       |
 
-A step that isn't needed for a given run shows as `·` rather than
-dropping out of the tree entirely, so the same kind of operation keeps a
+A step that isn't needed for a given run stays in the graph as `·` rather
+than being absent from it, so the same kind of operation keeps a
 recognizable shape run to run, whichever steps it actually needed.
+
+⚠️ **The view hides `✔` and `·` by default**, so that full shape isn't what
+you see first — tick them back on in the state filter. The selection is
+part of the request, not a display toggle: hidden states are never fetched.