The promotion model
The model the plugin is built around:
Author in staging org -> Export -> Commit .sdt to git -> CI imports to prodThe unit of promotion
Section titled “The unit of promotion”The unit of promotion is a .sdt file, a Sliick Docs Template archive. It carries:
- Template metadata: name, configuration, editor state.
- Bundle membership.
- Image files: watermark and image-block assets, at any size.
- Optionally, version history, with
--include-history.
How a .sdt is reviewed
Section titled “How a .sdt is reviewed”You commit .sdt files to git alongside your Apex and LWC. Each file is opaque and is reviewed by proofing the template in the org before export, not by reading the binary.
What does not travel this way
Section titled “What does not travel this way”Themes and org-wide settings (Docs_Theme__mdt, Docs_Setting__mdt) are custom metadata and continue to travel by Change Set or sf project deploy. The plugin handles templates and bundles only.