From 0d31560e380346991c3ce6aaeabb647768d9b8f5 Mon Sep 17 00:00:00 2001 From: atlas Date: Fri, 11 Sep 2026 14:21:34 +0200 Subject: [PATCH] docs/jobq: the queue view hides done and skipped steps by default MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit jobq.md's "Watching it happen" section ended by promising that a step which isn't needed "shows as `·` rather than dropping out of the tree entirely, so the same kind of operation keeps a recognizable shape run to run". In that view it does drop out. `JobqGraph.tsx:94` sets `DEFAULT_HIDDEN_STATES = {Done, Skipped}` under the comment 'Product call: "default selection filters out skipped and done"', `:299` seeds the selection as everything except those, and `:271` puts the selection in the query string — so the hidden states are never fetched, not merely styled out. That component is what renders both surfaces the page names, and neither passes an override. The claim is true of the data and false of the screen, in a section about what is on the screen. Keeping both: the node stays in the graph, and the default filter is named, along with the part that would otherwise surprise someone debugging it — the selection is a request parameter. Closes #4223. --- docs/scheduler/jobq.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) 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.