Uh oh!
There was an error while loading. Please reload this page.
docs: promise per-regime customization truth on integrations + build-without-code (ADR-0126 §8.4) - #12368
Merged
Merged
Conversation
…without-code ADR-0126 §1.3 documented a shipped over-promise: two capability pages told readers marketplace apps could be "customize[d] in Studio" without qualification, which held for views/dashboards but not for a packaged flow — locked at the write door and reachable only through disable+clone. §8 item 4 gates the correction on the L5 Setup surface existing (objectui#6382, merged), which it now does. Rewrite both promises to the three-regime truth: - presentational (views, dashboards) — edit directly, unchanged - behavioral (packaged flows) — locked; switch off and clone your own via Setup's packaged-automation page, then edit the clone in Studio - structural (packaged objects) — extend with your own fields via an extension package, never in-place edits to what shipped --- _Generated by [Claude Code](https://claude.ai/code/session_01KWRU3s15AJz7PGW7a7wdCh)_
os-support-ai
marked this pull request as ready for review
August 25, 2026 20:27
Uh oh!
There was an error while loading. Please reload this page.
9 tasks
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 freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Fixes#12161
Part of #12150 (Epic: ADR-0126 implementation, v17 line). Contract: ADR-0126 §1.3 + §8 item 4 (
28b47a93).What was over-promised
§1.3 recorded the shipped defect: two capability pages promised generic post-install "customize in Studio" for marketplace apps. Measured against the tier table, that promise was keepable for views/dashboards and for no tier-B type — flows specifically. §8 item 4 chartered the correction, gated on the L5 Setup surface existing (it now does: objectui#6382, merged
b362c1b, adds the Setup packaged-automation page — on/off + clone).What changed
Both passages are rewritten to the three-regime truth (ADR-0126 §2/§3):
content/docs/capabilities/integrations.mdx— the "Marketplace templates" bullet no longer promises a blanket "customize in Studio". It now says: views/dashboards are yours to edit directly; a packaged flow stays locked but can be switched off and cloned (via Setup) to edit in Studio; a packaged object grows through your own fields via an extension package, not by editing what shipped.content/docs/build-without-code.mdx— the Setup section's Marketplace clause gets the same per-regime breakdown, naming the packaged-automation page specifically since it lives in Setup (the section being described).No other pages touched, no restructuring — the promising passages only.
Tests
Local doc gates (see report for full command list and matched-family derivation via
node scripts/pm/dispatch-gates.mjs, run against merge-base017130a0):check:doc-authoring,check:doc-anchors,check:doc-formula-expressions,check:doc-security-posture, speccheck:docs,check:docs-audit-scope,check:docs-redirects,check:docs-single-h1, speccheck:empty-state, speccheck:liveness,check:published-readme-links,check:react-page-adapter-contract,check:role-word, speccheck:skill-examples, speccheck:strictness-ledger, speccheck:variant-docs,check-ci-filter-parity.mjs,check-cross-package-test-inputs.mjs,check-doc-frontmatter.mjs,check-doc-route-spelling.mjs,check-docs-section-name.mjs,check-section-landing-index.mjs,check:cross-package-test-inputs— all pass at heade7f41817.CI's full farm and the offline lychee link-checker run server-side; this PR does not wait on them (per-card convention).
Docs-only change;
skip-changesetlabel applied.Generated by Claude Code