Authoring stack: FSH, repo, packages (HL7 build + base template)
Use a software-engineering-grade authoring stack (FSH + CI + packages) and HL7 auto-build previews with the neutral base template.
Typical challenges in this area:
- Hand-edited JSON/XML drifts and becomes unreviewable
- Builds are slow or fail only in CI, not locally
- Template/dependency versions change and break rendering
- Branch naming or repo layout breaks HL7 auto-build
The Authoring Stack provide essential capabilities:
FSH-First, Repo-First Authoring
Use FSH + Git for diffable, distributed authoring; avoid hand-editing JSON/XML.
Key Benefits: - Reviewable diffs - Automation-friendly
Package-First IG Layout
Treat the IG as a versioned package with stable canonical + dependencies.
Key Benefits: - Reliable validation - Composable dependencies
HL7 Build Preview Pipeline (base template)
Use HL7 auto-build to generate previews for every push using fhir.base.template#current.
Key Benefits: - Immediate preview URLs - Shared debugging logs