improvement(docs): builder-first IA reorganization of the English docs - #4896

Merged

waleedlatif1 merged 115 commits into

simstudioai:stagingfrom

ouiliame:feat/docs-reorg

Jun 11, 2026

Commits on Jun 6, 2026

docs: reorganize into topic/ontology IA with a builder-first rewrite
ouiliame
and
claude
committed
18cee3d

Commits on Jun 8, 2026

feat(docs): spec-driven BlockPreview for block reference heroes
ouiliame
and
claude
committed
ce5b32e
fix(docs): correct stale navigation and removed-feature references
ouiliame
and
claude
committed
2a9230d

Commits on Jun 9, 2026

fix(docs): repair broken /docs-prefixed enterprise links
ouiliame
and
claude
committed
841e73c
fix(docs): refresh stale workflow-preview example blocks
ouiliame
and
claude
committed
099d14e
fix(docs): align BlockPreview input/output handles to the card edge
ouiliame
and
claude
committed
bdba6bd
docs(blocks): rewrite Agent reference to match the current block
ouiliame
and
claude
committed
1260685
docs(blocks): rewrite API reference to match the current block
ouiliame
and
claude
committed
0913574
docs(blocks): rewrite Condition reference to match the current block
ouiliame
and
claude
committed
8df8e46
docs(blocks): restore Best Practices + multi-example workflows on Condition
ouiliame
and
claude
committed
5d214ba
docs(blocks): restore Best Practices on Agent reference
ouiliame
and
claude
committed
b06228e
docs(blocks): restore Best Practices on API reference
ouiliame
and
claude
committed
4b11b8d
docs(blocks): rewrite Function reference to match the current block
ouiliame
and
claude
committed
3feeefc
docs(blocks): rewrite Router reference to match the current block
ouiliame
and
claude
committed
83c025a
docs(blocks): restore the classify and lead-qual examples on Router
ouiliame
and
claude
committed
3dbcc8b
docs(blocks): rewrite Response reference to match the current block
ouiliame
and
claude
committed
bd9d87f
docs(blocks): rewrite Variables reference to match the current block
ouiliame
and
claude
committed
e771efe
docs(blocks): rewrite Wait reference to match the current block
ouiliame
and
claude
committed
9ecfebf
docs(blocks): polish Credential reference (frontmatter, fold redundant tabs)
ouiliame
and
claude
committed
7aa2d80
docs(blocks): render the shared-credential example + icon fallback for integrations
ouiliame
and
claude
committed
7d411eb
docs(blocks): rewrite Evaluator reference to match the current block
ouiliame
and
claude
committed
d2acb94
docs(blocks): render the Credential route-by-logic example too
ouiliame
and
claude
committed
00f2614
docs(blocks): render Guardrails examples + light accuracy pass
ouiliame
and
claude
committed
553e8b5
docs(blocks): render Human-in-the-Loop examples + frontmatter
ouiliame
and
claude
committed
557cb35
docs(blocks): render Webhook examples + frontmatter
ouiliame
and
claude
committed
135cdd4
docs(blocks): add example + pageType to Workflow block reference
ouiliame
and
claude
committed
aebf100
docs(blocks): container rendering for Loop/Parallel + render the Loop example
ouiliame
and
claude
committed
47d6a7b
docs(blocks): fix the Loop container's Start-pill connector
ouiliame
and
claude
committed
0d058ea
docs(blocks): render the Parallel example + frontmatter (last core block)
ouiliame
and
claude
committed
19c309f
docs(blocks): prose glow-up for Guardrails to match the agent/condition voice
ouiliame
and
claude
committed
a79cf1a
docs(blocks): prose glow-up for Loop to match the agent/condition voice
ouiliame
and
claude
committed
227b0aa
docs(blocks): prose glow-up for Parallel to match the agent/condition voice
ouiliame
and
claude
committed
20ca934
docs(blocks): prose glow-up for Human-in-the-Loop
ouiliame
and
claude
committed
c7b6fa5
docs(blocks): re-enrich Loop prose (fuller, explanatory — not terse)
ouiliame
and
claude
committed
1a2f40b
docs(blocks): re-balance Parallel prose to the Agent/Condition register
ouiliame
and
claude
committed
6e1f266
docs(blocks): restore the Notification channel detail on HITL
ouiliame
and
claude
committed
f4089cd
docs(blocks): builder-voice polish on the Credential intro
ouiliame
and
claude
committed
645bbcc
docs(triggers): rewrite Start trigger in the builder voice
ouiliame
and
claude
committed
cc32437
docs(triggers): rewrite Schedule trigger in the builder voice
ouiliame
and
claude
committed
a59cb88
docs(triggers): refocus Webhook trigger on the generic (native) trigger
ouiliame
and
claude
committed
5e635b2
docs(triggers): builder-voice glow-up for RSS
ouiliame
and
claude
committed
ea4b1e9
docs(triggers): rewrite Table trigger off the auto-generated card
ouiliame
and
claude
committed
82d625c
docs(triggers): frame the index around native triggers + separate the catalog
ouiliame
and
claude
committed
22a8eab
docs: promote Core Blocks + Core Triggers into the Workflows area
ouiliame
and
claude
committed
f037c73
docs: merge block/trigger overviews into the Workflows overview; Core accordions
ouiliame
and
claude
committed
1405f79
docs: split integration triggers into their own Reference accordion
ouiliame
and
claude
committed
5f886b4
docs(workflows): trim the overview back to an introduction
ouiliame
and
claude
committed
ab1dd37
docs: relocate email-polling + trigger-priority out of the overview
ouiliame
and
claude
committed
88e7912
feat(docs-gen): emit per-service integration pages (actions + Trigger section)
ouiliame
and
claude
committed
519f8f3
feat(docs): unify tools + triggers into per-service /integrations pages
ouiliame
and
claude
committed
bc3e426
fix(docs): recover the hand-written manual-content intros on integration pages
ouiliame
and
claude
committed
6cfdd06
docs(scripts): rewrite the generator README for the integrations model
ouiliame
and
claude
committed
df87098
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
6c4526f
docs: regenerate integration docs from staging-synced apps/sim
ouiliame
and
claude
committed
4a4ea48
fix(docs-gen): don't let stale-doc cleanup delete hand-written integration pages
ouiliame
and
claude
committed
7d3e8fc
fix(docs-gen): stop cleanup/writer filter mismatch from eating manual content
ouiliame
and
claude
committed
ac0ddce
fix(docs): recover staging's enriched Table doc + never drop manual content
ouiliame
and
claude
committed
28a9ac5
docs(workspaces): de-philosophize the fundamentals prose
ouiliame
and
claude
committed
563f8af
fix(docs): restore #blocks and #triggers anchors on the workflows overview
ouiliame
and
claude
committed
2a04033
docs: restore the genuinely useful reference bits the rewrite dropped
ouiliame
and
claude
committed
676fb18
docs(blocks): rework the Agent intro — encyclopedia register
ouiliame
and
claude
committed
1502496
docs(integrations): add the HubSpot setup guide for the Marketplace listing
ouiliame
and
claude
committed
4d5d455
docs(integrations): rewrite the Integrations guide for the sidebar flow
ouiliame
and
claude
committed
e2e13ff
docs: move Building agents directly after Workflows in the sidebar
ouiliame
and
claude
committed
989017f
docs: fill the visual slots coverable by existing components
ouiliame
and
claude
committed
bda2f0a
docs(components): run-inspector OutputBundle + lightbox with block inspector
ouiliame
and
claude
committed
5c097f9
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
29e1475
docs: regenerate after staging merge — AppConfig joins integrations/
ouiliame
and
claude
committed
25cdf1c
docs: redirect the retired tools/ and trigger URLs to integrations/
ouiliame
and
claude
committed
9ad538b
docs(getting-started): rewrite — current UI, cut the post-tutorial padding
ouiliame
and
claude
committed
ef0913a
docs: de-fluff the Tier-1 heavy pages (logging, mcp, passing-files, permissions)
ouiliame
and
claude
committed
75db303
docs: tier-2 fluff trims (costs, enterprise, mailer, skills)
ouiliame
and
claude
committed
4549ec2
docs(skills): update to the Skills tab on the Integrations page + document import
ouiliame
and
claude
committed
6cbe417
docs(building-agents): render the lead-scorer running example on choosing
ouiliame
and
claude
committed
2b8b25c
docs(tables): rewrite workflow columns around the real lead-scoring example
ouiliame
and
claude
committed
cb80202
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
84e81ee
docs: regenerate after staging merge — Slack trigger update + file block re-visible
ouiliame
and
claude
committed
5e7c3a3
docs(tables): playbook prose pass on workflow columns + restore File block links
ouiliame
and
claude
committed
2a3c11b
docs(tables): per-row execution inspection on workflow columns
ouiliame
and
claude
committed
16a178e
docs(workflows): drop the confusing 'order by hand' sentence
ouiliame
and
claude
committed
922371e
docs(workflows): fix the over-claim about independent blocks
ouiliame
and
claude
committed
8e0af92
docs(workflows): accuracy audit of how-it-runs against the executor
ouiliame
and
claude
committed
0e8fd27
docs(logs): real captures on the overview + prose matched to the UI
ouiliame
and
claude
committed
8304bb8
docs(workflows): one reference syntax, named sources — untangle variables vs connection tags
ouiliame
and
claude
committed
4c76792
docs(workflows): verify the reference model against the resolver; fix one imprecision
ouiliame
and
claude
committed
ae5ce65
docs(building-agents): workflow-as-tool is agent-decided, not the Workflow block
ouiliame
and
claude
committed
4e0da53

Commits on Jun 10, 2026

docs: theme-aware previews + enrichments vs workflow groups split
ouiliame
and
claude
committed
4035a6b
docs(tables): don't enumerate the enrichment catalog; don't assert a group's kind
ouiliame
and
claude
committed
85138c4
docs(components): per-branch source handles — conditions and routers finally branch
ouiliame
and
claude
committed
a1c9076
docs(components): inspector shows branch rows
ouiliame
and
claude
committed
d7fbbef
docs(components): branch handle ids match the app's workflow representation
ouiliame
and
claude
committed
a74962d
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
18d2bbc
docs: agent skills mint /integrations/ docs links and describe the new output
ouiliame
and
claude
committed
8015716
docs(workflows): execution semantics, not simultaneity
ouiliame
and
claude
committed
68e79c2
docs(workflows): errors are execution semantics — own section on how-it-runs
ouiliame
and
claude
committed
dfcb6d7
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
9ed98f3
docs: data-driven additions from the platform-metrics read
ouiliame
and
claude
committed
3d48fd6
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
0f4a024
docs: regenerate after staging merge (integration validation batch + Gong tools)
ouiliame
and
claude
committed
285067f
docs: rename Building agents -> Agents; URLs match the settled IA
ouiliame
and
claude
committed
caf1e04
docs(workflows): connections gets its video, an FAQ, and accurate output examples
ouiliame
and
claude
committed
3c929f4
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
aae00a9
docs: regenerate after staging merge — sim trigger, enrichment + logs blocks, re-shown DB integrations
ouiliame
and
claude
committed
ad054e5
Merge remote-tracking branch 'origin/staging' into feat/docs-reorg
ouiliame
committed
ce43834
docs: regenerate after staging merge (CodePipeline); suppress sim trigger from catalog
ouiliame
and
claude
committed
ed57d9c
docs(blocks): cross-link the Memory block from the Agent memory section
ouiliame
and
claude
committed
a92d308
docs: URLs now mirror the sidebar — sections own their pages
ouiliame
and
claude
committed
9811d6b
docs: untrack .plans/ (local agent planning files)
ouiliame
and
claude
committed
cda8b06
docs(preview): tool chips use the EMCN ChipTag chrome
ouiliame
and
claude
committed
85e2a01
chore(blocks): one-time shift of all docsLinks to the new docs URLs
ouiliame
and
claude
committed
e1cb924
docs: ignore .plans/ (local agent planning files)
ouiliame
and
claude
committed
887cad1

Commits on Jun 11, 2026

docs(files): align every File-block claim with the shipped file_v5 block
ouiliame
and
claude
committed
2b03b35
docs: keyboard-shortcuts audited against the command registry; cut legacy workspace detail
ouiliame
and
claude
committed
b489484
docs: apply Theodore's accuracy feedback
ouiliame
and
claude
committed
c563f48
docs: Python sandbox package list (verified) + agent/agents cross-linking
ouiliame
and
claude
committed
649b01c