Repository navigation
docs(product-docs): assembler operator help HTML-first/Markdown/Velocity (#4433) - #4437
Merged
natechadwick-intsof merged 1 commit intoSep 9, 2026
Merged
Conversation
…ity (#4433) Document Design SPA assembler choice on the existing Design templates page (stable id admin-design-templates): HTML-first default, Markdown, and Velocity preferred over Legacy/XSL. Cross-link Developer Templates, Getting Started, and glossary. Do not touch pipeline hot-path pages. Fixes #4433 Parent: #2632 Grandparent: #2626 > Co-Authored by Grok Build 1.0.24 using grok-4.6 with agent night-issue-prs.
natechadwick-intsof
added
documentation
natechadwick-intsof
deleted the
feat/issue-4433-assemblers-operator-help
branch
September 9, 2026 13:58
This was referenced Sep 12, 2026
natechadwick
pushed a commit
that referenced
this pull request
Sep 19, 2026
…#4594) README status table still showed Phase 1 in progress and Phases 2-5 blocked, although Phases 0-4 are closed and all six Phase 5 docs slices merged (#2845/#2851/#2853/#4437/#4442/#4445). Mark phases done, point operators at the live product-docs help pages, and keep the #2852 shim-removal hard gate explicit. Fixes #2632 Parent: #2626 > Co-Authored by OpenCode 1.18.31 using muse-spark-1.3-contributor-free with agent night-issue-prs.
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.
Summary
Operator-facing product-docs 8.2 for choosing HTML-first, Markdown, or Velocity assemblers on Design / Developer Templates, matching shipped 8.2 (Design SPA picker + REST create default).
id: admin-design-templates) with assembler catalog, when-to-choose, placeholder syntax, JEXL note, change steps, and specialized/legacy picker rows.product-docs/8.2/developer/rest.md,admin/developer-pipelines.md,admin/index.md,developer/index.md, WebUI,sitemanage-beans.xml, perc-qa-automationpackage.json).PSLegacyDefinitionXmlShim(Phase 5 residual: remove definition-XML dual-run shim when criteria met #2852).Fixes #4433
Parent: #2632
Grandparent: #2626
Siblings (untouched): #4434, #4435
Operator: Grok: night-issue-prs (model grok-4.6)
Test plan
product-docs/8.2/admin/design-templates.mdassembler section against Design SPA Assembler list (HTML-first★ default, Markdown ★, Velocity ★, Page, Legacy / XSL, Binary, Dispatch, Database).#choose-an-assembler-html-first-markdown-velocityandid:links toadmin-design-templates,admin-developer-templates,developer-rest,reference-glossary.scripts/ci-smoke-product-docs.sh(Windows:scripts\ci-smoke-product-docs.bat).<code>${title}</code>/${dotted.path}(entities in source) and heading idchoose-an-assembler-html-first-markdown-velocity.Checklist
product-docs/8.2/(admin/design-templates.md,admin/developer-templates.md,getting-started/index.md,reference/glossary.md)scripts/ci-smoke-product-docs.shOK — Built 48 page(s), foundtmp/product-docs-site/8.2/index.html.sh/.bat)C3 evidence
modules_built=(none — not a Maven change)build_evidence=cdworktree root;bash scripts/ci-smoke-product-docs.sh→ci-smoke-product-docs: OK — found …/tmp/product-docs-site/8.2/index.html(Built 48 page(s))downstream_checked=none (C2 API shape did not apply)C5 UI proof
N/A — product-docs only; no WebUI / Playwright surface.
Erlang
docs/ai-generated/code-reviews/issue-4433-assemblers-operator-help-erlang.md— approve; May commit/push: yes.