Skip to content

Update FSH Seminar and Deep Dive Content for 2026#6

Open
cmoesel wants to merge 10 commits intomainfrom
apr-2026-updates
Open

Update FSH Seminar and Deep Dive Content for 2026#6
cmoesel wants to merge 10 commits intomainfrom
apr-2026-updates

Conversation

@cmoesel
Copy link
Copy Markdown
Contributor

@cmoesel cmoesel commented Apr 10, 2026

This PR updates the FSH Seminar and Deep Dive Content to reflect the tools, processes, and IGs that are most appropriate for April 2026. Each commit contains details of its changes, but the following is a list of the high-level changes for FSH Seminar content:

  • Update all VS Code FSH extension links to point to the new HL7-maintained FSH extension
  • Update all references to _updatePublisher and _genonce scripts to refer to _build scripts instead
  • Update IG-related content to reflect latest IG Publisher outputs (including diagrams and screenshots of profile pages)
  • Update FHIR core extensions to link to extension pack pages when appropriate
  • Update all mCODE-related content (including screenshots, examples, and exercises) to reflect mCODE STU4
  • Update all USCore-related content (including screenshots, examples, and exercises) to reflect US Core 6.1.0
  • Update mCODE and USCore links to link to version-specific pages when appropriate
  • Update sushi init video to show new inputs and outputs
  • Refer readers to #shorthand Zulip stream instead of #fsh-courses
  • Other small content updates as appropriate (e.g., support for mermaid diagrams, remove references to trifolia, etc.)
  • Grammar, spelling, and hyperlink fixes as necessary

FSH Deep Dive content is still largely relevant and correct, but due to the video format could not be tweaked as easily as FSH Seminar content. The following is a list of high-level changes to the slide notes for Deep Dive content:

  • Update US Core links to point to US Core STU4 since that is the version referenced in the slides and video
  • Update mCODE links to point to mCODE STU1 since that is the version referenced in the slides and video
  • Update VS Code FSH extension link to point to the new HL7-maintained FSH extension
  • Add links to new resources of interest such as the extension pack registry and FhirPath Lab
  • Add notes about new features introduced in FSH 3.0 (Context keyword, concept caret rules, double-square bracket syntax for insert rules)
  • Other small content updates as appropriate (e.g., note that pattern discriminator is deprecated, remove references to trifolia, etc.)
  • Add missing links from slides and fix broken links from slides

NOTE 1: As of Apr 10, sushi init still downloads the old _updatePublisher and _genonce scripts, but the next version of SUSHI will switch to _build scripts (see: FHIR/sushi#1619)) -- so I updated the docs here anticipating that change.

NOTE 2: This PR should be merged around the same time as FSHSchool/courses-fsh-seminar-exercise#1.

cmoesel added 10 commits March 26, 2026 11:48
- Replace Deep Dive TBD with real topics
- Replace SMART Cards link w/ mCODE link
- Minor grammar fixes
- Point to newer FHIR introduction video (2025 vs 2019)
- Point to new FSH Plugin (now owned by HL7)
- Use `_build` scripts instead of `_updatePublisher`/`_genonce`
- Fix incorrect IG paths
- Minor grammar / punctuation
- Replace mCODE GitHub links with IG links
- Reference DaVinci CDex as an example of "community of implementation" IG
- Indicate that OperationDefinition is also a good place to start for understanding APIs in an IG
- When reviewing specific mCODE profiles, always link to mCODE STU2
- Fix link to FHIR core description of MustSupport (anchor changed in R5)
- Grammar and spelling

NOT DONE: I did not update mCODE discussions to STU4 or update screenshots, but we should probably do this.
- Link to mCODE STU2 for mCODE example
- Link to US Core STU 6 for US Core examples
- Link to core extensions from Extensions pack
- Add information about Mermaid diagrams
- Add links to IG Guidance on adding Mermaid/PlantUML diagrams
- Replace references to _updatePublisher / _genonce with _build
- Add note about canonical vs documentation URLs
- Use sushi init instead of sushi --init
- Point to new FSH Plugin (now owned by HL7)
- Grammar and spelling

NOTE DONE: I did not update mCODE discussions to STU4 or update screenshots / videos, but we should probably do this.
- Reference and link to US Core STU 6
- Fix broken link in premise
- Use `_build` instead of `_genonce`
- Note that FSH Online may need US Core dependency set in config
- Fix link to VS Code extension
- Grammar / typos
- Update YouTube links
- Add chat.fhir.org
- Remove references to Trifolia-on-FHIR
- Add US Core STU4 links to match screenshots
- Link to mCODE STU1 to match screenshot
- Add link to latest extension registry
- Add link to FhirPath Lab Tester
- Change VS Code extension link to HL7-maintained version
- Note that pattern discriminator is deprecated
- Note that FSH 3.0 added support for Context keyword
- Add FSH Online examples that use Context keyword
- Note that FSH 3.0 adds support for setting concept metadata using caret rules
- Note that FSH 3.0 adds support for using double-square brackets when inserting parameterized rule sets

- Add missing links
- Fix broken links
- Update the diagrams and screenshots to reflect current IG Publisher outputs.
- Update content to reflect current IG Publisher outputs.
- Update screenshots to reflect mCODE STU4.
- Update mCODE discussion to match STU4 content.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant