[SC-16950] Document the workflows list table and workflow details page - #1484
Draft
emmavdh wants to merge 1 commit into
Draft
[SC-16950] Document the workflows list table and workflow details page#1484emmavdh wants to merge 1 commit into
emmavdh wants to merge 1 commit into
Conversation
Documents the redesigned Settings > Workflows list (unified table with search, sort, filter, and count) and the new workflow details page (properties rail, version history, read-only diagram with Edit Workflow, and active executions), and routes the clone/edit/delete/publish flows through the new experience. Co-Authored-By: Claude Fable 5 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request Description
Important
Draft — iterating with screenshots to follow, and the details page ships behind a LaunchDarkly flag.
launchdarkly.rollout.workflows-details-pageis being flipped off by default in validmind/frontend#2844, so the details page is only live where LD explicitly serves it. Confirm the flag will be enabled for 26.09 before merging.What and why?
Documents sc-16950 — the redesigned Settings → Workflows list and the new workflow details page (tracker: sc-17996 / Docs 26.09). Shipped in validmind/frontend#2803 and validmind/backend#3463, both merged.
Previously, clicking a workflow in Settings opened the canvas editor directly. Workflows now land on a details page that separates reviewing/monitoring a workflow from editing its configuration.
Summary of changes
_configure-workflow-steps.qmd(shared include, HTML + revealjs blocks) — Step navigation now goes list → details page → Edit Workflow → canvas._publish-workflows.qmd(shared include) — "Hover over" updated to match the table, and the details-page publish path added.The section heading and anchor
#view-sort-and-filter-workflowswere deliberately kept stable — several pages footnote it.How to test
Try the live preview (allow time for the PR preview deploy to finish):
All three pages render clean locally with
quarto render --profile development(only the pre-existingvalidmind/validmind.qmdwarning). Verified in the rendered HTML: the#view-workflow-detailsanchor resolves, all five new footnotes render (no literal[^n]markers), and the training deck picks up the new editor step exactly once.What needs special review?
WorkflowDetailsPage,WorkflowExecutionsTable, listtableColumns), not a live click-through: Edit Details / Clone Workflow / Publish Workflow / Delete Workflow, the rail fields (Target, Target Type, Status, Workflow Start, Expected Duration), the Version drop-down, Edit Workflow, and the Active Executions columns (Name, Stage, Record Owner). Worth a check against the live UI once the flag is on.workflows-details-pageoff, clicking a workflow still opens the canvas directly (the old flow). Also note the Status and Created By columns are separately gated onworkflows-draft-status.Dependencies, breaking changes, and deployment notes
workflows-details-pageoffline default to off; docs should not go live to prod before the flag is enabled for the release.Release notes
The Settings → Workflows page now lists all workflows in a single table you can search, sort, and filter — and clicking a workflow opens a new details page where you can review its properties, browse version history, preview the workflow diagram, and monitor active executions before opening the editor. Learn more ...
Checklist