Skip to content

docs: consistent dynamic-variable preview and run with sample values (20580)#193

Draft
ManuelGerding wants to merge 4 commits into
mainfrom
docs/20580-dynamic-variable-sample
Draft

docs: consistent dynamic-variable preview and run with sample values (20580)#193
ManuelGerding wants to merge 4 commits into
mainfrom
docs/20580-dynamic-variable-sample

Conversation

@ManuelGerding

@ManuelGerding ManuelGerding commented Jul 9, 2026

Copy link
Copy Markdown
Member

Documents the design-time consistency behavior for dynamic variable values (ticket 20580).

What

Two new subsections under Dynamic Value in use-steadybit/experiments/variables.md:

  • Sample Values in Experiment Editor — Steadybit pins one preview sample (on open, on environment change, and when a dynamic value is created/edited) and reuses it across per-step counts, the Show targets list, and the values shown under each variable, so previews stop disagreeing. Covers the Resample dynamic variable values action and that the sample is a design-time preview only (never saved).
  • Run with Sample Values — the second Run Experiment split-button option and the dialog that pins a single run to the previewed values.

⚠️ Dependency

Targets main, but the branch is stacked on #192 (docs/20792-multi-value-fixed-variables) and requires #192 to be merged first — the two features release together. Until #192 merges, this PR's diff also shows #192's changes; once #192 lands in main, only these changes remain.

Notes

  • Screenshots are left as <!-- TODO screenshot: … --> placeholders (3) — to be added before merge.
  • No SUMMARY.md change (edits an existing page).

…eries

- Variables: rename the "Fixed and Dynamic Values" section to "Value Settings"
  and describe the three value kinds, adding a "List of Fixed Values" section
  (per-value IN(...) expansion, comma-join in scalar contexts, no comma-splitting
  of a single value).
- Query Language: add a "Using variables and placeholders" section covering
  {{variable}} / [[placeholder]] markers as values (quoted or unquoted), the
  IN ({{var}}) matches-any behaviour, and that a =/!= comparison against a
  multi-value variable is equivalent to IN/NOT IN.
- Update the environment and service variable cross-links to the renamed anchor.

(ticket 20792)
ticket 20792
…e values

Adds two subsections under Dynamic Value: the pinned design-time sample
(consistent counts/previews, "Resample dynamic variable values") and the
"Run with sample values" run option.

(ticket 20580)
@ManuelGerding ManuelGerding changed the base branch from docs/20792-multi-value-fixed-variables to main July 9, 2026 14:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant