FE-1490: Add the ad-hoc scenarios user guide - #9290
Draft
kube wants to merge 5 commits into
Draft
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
github-actions
Bot
added
area/infra
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 23, 2026 14:18
2c6a08f to
95db31d
Compare
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 23, 2026 14:40
95db31d to
1905429
Compare
This was referenced Aug 23, 2026
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 23, 2026 15:42
1905429 to
94bde30
Compare
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 24, 2026 01:03
94bde30 to
ba21902
Compare
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 24, 2026 01:11
ba21902 to
e966362
Compare
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 24, 2026 01:45
e966362 to
26ef448
Compare
The guide now covers the form's keyboard grid (arrows and Tab across every table, the count strip on the vertical path, the gutter as row selection with Enter for the kind menu and Delete for removal), the Variables phantom row and cell-style name editing, and the form-level undo history.
kube
force-pushed
the
cf/fe-1490-ad-hoc-scenario-user-guide
branch
from
August 24, 2026 10:53
26ef448 to
dcc4393
Compare
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.
🌟 What is the purpose of this PR?
The docs layer for the ad-hoc scenario feature, closing stack #9286: a user-guide page for the shared form, cross-references in the three consumer pages, and registration with the in-app AI assistant's doc reader.
🔗 Related links
🔍 What does this change?
docs/ad-hoc-scenarios.md: where the form appears (quick simulation, experiments, optimizations), the form's sections (parameters, variables, per-place initial state), fixed vs template rows, shared columns, per-place variables, Optimize selections with the generatedadhoc.*parameter names, and error surfacing. Linked fromdocs/README.md.simulation.mddocuments the "Define initial state" pencil button;experiments.mddocuments the "No scenario" branch and the "Ad-hoc scenario" table label;optimization.md's prerequisites and creation steps now cover "Ad-hoc (define inline)".ad-hoc-scenariosadded topetrinautDocNamesandpetrinautDocSummariesinpetrinaut-core/src/ai.ts, with the?rawimport inpetrinaut-docs-content.ts. The existing tests enforce that every doc name has a summary and a content entry.Pre-Merge Checklist 🚀
🚢 Has this modified a publishable library?
This PR:
patchfor both packages).📜 Does this require a change to the docs?
The changes in this PR:
🕸️ Does this require a change to the Turbo Graph?
The changes in this PR:
🛡 What tests cover this?
The existing
ai.test.tsandpetrinaut-docs-content.test.tstests enforce that the new doc name has a summary and a content entry.❓ How to test this?
turbo run test:unit --filter @hashintel/petrinaut --filter @hashintel/petrinaut-corereadPetrinautDoc.🐾 Next steps
The new page has no screenshots yet; they should be added once the UI is reviewed and final.
🤖 Generated with Claude Code