FHIR · GinoCanessa · May 6, 2026 · May 5, 2026 · May 5, 2026 · May 6, 2026
diff --git a/.github/skills/dev-do/SKILL.md b/.github/skills/dev-do/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: dev-do
-description: "Executes an implementation plan produced by `dev-plan` in the role of a staff-level Engineer. USE FOR: actually doing the work — writing/modifying code, running builds and tests, committing locally as phases complete, and keeping `plan.md` updated with current status. Accepts either a full path to the plan file or a short slot number that expands to `scratch/[MMDD]-[##]/plan.md`. Optional `max_subagents` (default 3) caps parallel sub-agent fan-out. Optional `checkpoint_every` (default 0 = never) yields back to the user after every N completed phases; the default is to run the entire plan in a single invocation without re-prompting. May commit locally with concise conventional-commit messages, but **must not push and must not open a PR**. The `plan.md` file may be edited but never deleted."
+description: "Executes an implementation plan produced by `dev-plan` in the role of a staff-level Engineer. USE FOR: actually doing the work — writing/modifying code, running builds and tests, committing locally as phases complete, and keeping `plan.md` updated with current status. Accepts either a full path to the plan file or a short slot number that expands to `scratch/[MMDD]-[##]/plan.md`. Optional `max_subagents` (default 3) caps parallel sub-agent fan-out. Optional `checkpoint_every` (default 0 = never) yields back to the user after every N completed phases; the default is to run the entire plan in a single invocation without re-prompting. May commit locally with concise conventional-commit messages, but **must not push and must not open a PR**. The `plan.md` file may be edited but never deleted nor committed."
 ---
 
 # Dev Do Skill
@@ -65,9 +65,9 @@ invocation. The default contract is:
 
 - Run **all** remaining `Pending` phases back-to-back.
 - A successful verification + commit is **not** a yield point.
-  Updating `plan.md` and committing is a normal step inside the loop;
-  immediately mark the next `Pending` phase `In-progress` and keep
-  going.
+  Updating `plan.md` and committing code is a normal step inside 
+  the loop; immediately mark the next `Pending` phase `In-progress` 
+  and keep going.
 - Yield to the user **only** for the reasons enumerated in
   "Yield Conditions" below.
 
@@ -144,14 +144,11 @@ sibling source request (`featurerequest.md` / `bugreport.md`).
       `Complete` and append a `## Progress Log` entry (with the
       pending commit SHA placeholder; you'll fill it in after the
       commit, or amend immediately after).
-   5. Stage **both** the code changes and the `plan.md` update and
-      commit them together as a single phase commit with a concise
+   5. Stage the code changes (not the `plan.md`) update and
+      commit as a single phase commit with a concise
       conventional-commit message (`<type>(<scope>): <subject>`,
       e.g., `fix(github-source): handle empty FSH alias map`). Include
-      the standard co-author trailer required by this repo. Folding
-      the plan update into the phase commit is the default; a
-      separate `chore(plan):` commit is allowed only when the code
-      and plan changes are genuinely independent.
+      the standard co-author trailer required by this repo.
    6. **Continue immediately to the next `Pending` phase. Do not
       yield.** Successful verification + commit is *not* a stopping
       point. The only legal reasons to break out of this loop are the

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
@@ -2,55 +2,74 @@ name: Docs
 
 on:
   push:
-    branches:
-    - main
+    branches: [main]
     paths:
-    - src/**
-    - docfx/**
-    - .github/workflows/docs.yml
+      - 'src/**'
+      - 'docs/**'
+      - 'docfx/**'
+      - '.github/workflows/docs.yaml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'docs/**'
+      - 'docfx/**'
+      - '.github/workflows/docs.yaml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
 
 env:
-  DOTNET_VERSION: '9'           # The .NET SDK version to use
+  DOTNET_VERSION: '9'
 
 jobs:
-  generate-docs:
-    runs-on: windows-latest
-    steps:
-    - uses: actions/checkout@v3
-    - name: Setup .NET Core
-      uses: actions/setup-dotnet@v3
-      with:
-        dotnet-version: ${{ env.DOTNET_VERSION }}
-
-    - name: Setup DocFX
-      uses: crazy-max/ghaction-chocolatey@v1
-      with:
-        args: install docfx
-
-    - name: DocFX Build
-      run: docfx ./docfx/docfx.json
-      continue-on-error: false
-
-    - name: Upload Artifact
-      uses: actions/upload-artifact@v1
-      with:
-        name: site
-        path: docfx/_site
-
-  deploy:
-    concurrency: ci-${{ github.ref }}
-    needs: [generate-docs]
+  build:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-
-      - name: Download Artifact
-        uses: actions/download-artifact@v1
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
         with:
-          name: site
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Install DocFX
+        run: dotnet tool install -g docfx
+
+      - name: Restore + build solution (needed for metadata + CLI emitter)
+        run: dotnet build fhir-codegen.sln -c Release
 
-      - name: Deploy
-        uses: JamesIves/github-pages-deploy-action@v4
+      - name: Generate CLI Markdown into docs content path
+        run: |
+          dotnet run --no-build --configuration Release \
+            --project src/fhir-codegen/fhir-codegen.csproj -- \
+            docs cli --output docs/articles/cli.md
+
+      - name: Build site
+        run: docfx ./docfx/docfx.json --warningsAsErrors
+
+      - name: Configure Pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v3
         with:
-          folder: 'site'
+          path: docfx/_site
+
+  deploy:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,8 +1,8 @@
 
-### 1.0.1
+### CURRENT
 
-* DSTU2
-  * Fixed incorrect mapping of QuestionnaireResponseGroup to QuestionnaireGroup
+* Migrated from Microsoft/fhir-codegen to FHIR/fhir-codegen.
+* Documentation site restored at https://fhir.github.io/fhir-codegen/.
 
 ---
 

diff --git a/CLAUDE.md b/CLAUDE.md
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -1,9 +1,3 @@
-# Microsoft Open Source Code of Conduct
+# HL7 Code of Conduct
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-
-Resources:
-
-- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
-- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
-- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
+To ensure a welcoming environment, we follow the [HL7 Code of Conduct](https://www.hl7.org/legal/code-of-conduct.cfm).
diff --git a/CONTRIBUTING.MD b/CONTRIBUTING.MD
@@ -0,0 +1,36 @@
+# Contributing
+
+This document describes guidelines for contributing to this repo.
+
+To ensure a welcoming environment, we follow the [HL7 Code of Conduct](https://www.hl7.org/legal/code-of-conduct.cfm) and expect contributors to do the same.
+
+Before making a contribution, please familiarize yourself with this document, as well as our [LICENSE](LICENSE) and [README](README.md).
+
+
+## Submitting Pull Requests
+
+- **DO** submit all changes via pull requests (PRs). They will be reviewed and potentially be merged by maintainers after a peer review that includes at least one of the team members.
+- **DO** give PRs short but descriptive names.
+- **DO** write a useful but brief description of what the PR is for.
+- **DO** refer to any relevant issues and use [keywords](https://help.github.com/articles/closing-issues-using-keywords/) that automatically close issues when the PR is merged.
+- **DO** ensure each commit successfully builds. The entire PR must pass all checks before it will be merged.
+- **DO** address PR feedback in additional commits instead of amending.
+- **DO** assume that [Squash and Merge](https://blog.github.com/2016-04-01-squash-your-commits/) will be used to merge the commits unless specifically requested otherwise.
+- **DO NOT** submit "work in progress" PRs. A PR should only be submitted when it is considered ready for review.
+- **DO NOT** mix independent and unrelated changes in one PR.
+
+## Coding Style
+
+The coding style is enforced through [StyleCop.Analyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers), [.editorconfig](.editorconfig), and [stylecop.json](stylecop.json). Contributors should ensure these guidelines are followed when making submissions.
+
+- **DO** address the StyleCop.Analyzers errors.
+- **DO** follow the [.editorconfig](.editorconfig) and [stylecop.json](stylecop.json) settings.
+
+## Creating Issues
+
+- **DO** use a descriptive title that identifies the issue or the requested feature.
+- **DO** write a detailed description of the issue or the requested feature.
+- **DO** provide details for issues you create:
+  - Describe the expected and actual behavior.
+  - Provide any relevant exception message or OperationOutcome.
+- **DO** subscribe to notifications for created issues in case there are any follow-up questions.
diff --git a/GeoPol.xml b/GeoPol.xml
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
     MIT License
 
-    Copyright (c) Microsoft Corporation.
+    Copyright (c) Gino Canessa. All rights reserved.
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@
     AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
+    SOFTWARE