Document workflow comparison
The JSON renderer is the current workflow for html-comms. This comparison explains when to use it and when to edit HTML directly.
Workflow comparison
Approach | Model authors | Tradeoff |
|---|---|---|
Shared HTML shell | Body markup and content | Flexible body layout, with more markup to maintain. |
JSON renderer | Text, section headings, and block selections | Consistent markup; unusual layouts require an explicit HTML edit. |
Current workflow
Use the JSON renderer for plans and comparisons. It applies the shared document design, checks the result, and prepares publication. Published documents appear in the homepage library. Use the custom HTML path when a document needs a different layout.
Measurement
Rendering and publication have been tested. Token savings have not been established through a controlled comparison.