Add website with API docs, XML doc examples, and CI optimization

.github/workflows/ci.yml

@@ -3,8 +3,24 @@ name: CI
 on:
   push:
     branches: [main]
+    paths:
+      - '**/*.cs'
+      - '**/*.csproj'
+      - '**/*.sln'
+      - '**/Directory.Build.props'
+      - '**/Directory.Packages.props'
+      - '.github/workflows/ci.yml'
+      - '.config/dotnet-tools.json'
   pull_request:
     branches: [main]
+    paths:
+      - '**/*.cs'
+      - '**/*.csproj'
+      - '**/*.sln'
+      - '**/Directory.Build.props'
+      - '**/Directory.Packages.props'
+      - '.github/workflows/ci.yml'
+      - '.config/dotnet-tools.json'
   workflow_dispatch:
 
 env:
@@ -13,6 +29,68 @@ env:
   DOTNET_CLI_TELEMETRY_OPTOUT: true
 
 jobs:
+  # Detect which areas changed to conditionally run tests
+  changes:
+    name: Detect Changes
+    runs-on: ubuntu-latest
+    outputs:
+      dataprovider: ${{ steps.filter.outputs.dataprovider }}
+      lql: ${{ steps.filter.outputs.lql }}
+      migration: ${{ steps.filter.outputs.migration }}
+      sync: ${{ steps.filter.outputs.sync }}
+      gatekeeper: ${{ steps.filter.outputs.gatekeeper }}
+      samples: ${{ steps.filter.outputs.samples }}
+      dashboard: ${{ steps.filter.outputs.dashboard }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            dataprovider:
+              - 'DataProvider/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            lql:
+              - 'Lql/**'
+              - 'DataProvider/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            migration:
+              - 'Migration/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            sync:
+              - 'Sync/**'
+              - 'Migration/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            gatekeeper:
+              - 'Gatekeeper/**'
+              - 'DataProvider/**'
+              - 'Migration/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            samples:
+              - 'Samples/**'
+              - 'DataProvider/**'
+              - 'Sync/**'
+              - 'Migration/**'
+              - 'Gatekeeper/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+            dashboard:
+              - 'Samples/Dashboard/**'
+              - 'Samples/Clinical/**'
+              - 'Samples/Scheduling/**'
+              - 'DataProvider/**'
+              - 'Sync/**'
+              - 'Migration/**'
+              - 'Gatekeeper/**'
+              - 'Directory.Build.props'
+              - 'Directory.Packages.props'
+
   build:
     name: Build
     runs-on: ubuntu-latest
@@ -46,22 +124,59 @@ jobs:
       - name: Build
         run: dotnet build --no-restore -c Release
 
-  # Tests that only need SQLite (no Docker)
-  unit-tests:
-    name: Unit Tests
+  # DataProvider tests
+  dataprovider-tests:
+    name: DataProvider Tests
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build, changes]
+    if: needs.changes.outputs.dataprovider == 'true'
     strategy:
       fail-fast: false
       matrix:
         project:
           - DataProvider/DataProvider.Tests
           - DataProvider/DataProvider.Example.Tests
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Cache NuGet packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Restore
+        run: dotnet restore ${{ matrix.project }}
+
+      - name: Test
+        run: dotnet test ${{ matrix.project }} --no-restore --verbosity normal --logger "trx;LogFileName=test-results.trx"
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results-dataprovider-${{ strategy.job-index }}
+          path: '**/TestResults/*.trx'
+
+  # LQL tests
+  lql-tests:
+    name: LQL Tests
+    runs-on: ubuntu-latest
+    needs: [build, changes]
+    if: needs.changes.outputs.lql == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        project:
           - Lql/Lql.Tests
           - Lql/LqlCli.SQLite.Tests
-          - Migration/Migration.Tests
-          - Sync/Sync.Tests
-          - Sync/Sync.SQLite.Tests
     steps:
       - uses: actions/checkout@v4
 
@@ -88,34 +203,63 @@ jobs:
         uses: actions/upload-artifact@v4
         if: always()
         with:
-          name: test-results-unit-${{ strategy.job-index }}
+          name: test-results-lql-${{ strategy.job-index }}
           path: '**/TestResults/*.trx'
 
-  # API integration tests (SQLite, no Docker)
-  api-tests:
-    name: API Tests
+  # Migration tests
+  migration-tests:
+    name: Migration Tests
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build, changes]
+    if: needs.changes.outputs.migration == 'true'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Cache NuGet packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Restore
+        run: dotnet restore Migration/Migration.Tests
+
+      - name: Test
+        run: dotnet test Migration/Migration.Tests --no-restore --verbosity normal --logger "trx;LogFileName=test-results.trx"
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results-migration
+          path: '**/TestResults/*.trx'
+
+  # Sync SQLite tests (no Docker)
+  sync-sqlite-tests:
+    name: Sync SQLite Tests
+    runs-on: ubuntu-latest
+    needs: [build, changes]
+    if: needs.changes.outputs.sync == 'true'
     strategy:
       fail-fast: false
       matrix:
         project:
-          - Gatekeeper/Gatekeeper.Api.Tests
-          - Samples/Clinical/Clinical.Api.Tests
-          - Samples/Scheduling/Scheduling.Api.Tests
-          - Samples/Dashboard/Dashboard.Web.Tests
+          - Sync/Sync.Tests
+          - Sync/Sync.SQLite.Tests
     steps:
       - uses: actions/checkout@v4
 
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: |
-            8.0.x
-            ${{ env.DOTNET_VERSION }}
-
-      - name: Restore .NET tools
-        run: dotnet tool restore
+          dotnet-version: ${{ env.DOTNET_VERSION }}
 
       - name: Cache NuGet packages
         uses: actions/cache@v4
@@ -135,14 +279,15 @@ jobs:
         uses: actions/upload-artifact@v4
         if: always()
         with:
-          name: test-results-api-${{ strategy.job-index }}
+          name: test-results-sync-sqlite-${{ strategy.job-index }}
           path: '**/TestResults/*.trx'
 
-  # Tests that need Docker for Postgres (via Testcontainers)
-  postgres-tests:
-    name: Postgres Tests
+  # Sync Postgres tests (need Docker)
+  sync-postgres-tests:
+    name: Sync Postgres Tests
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build, changes]
+    if: needs.changes.outputs.sync == 'true'
     strategy:
       fail-fast: false
       matrix:
@@ -172,21 +317,103 @@ jobs:
       - name: Test
         run: dotnet test ${{ matrix.project }} --no-restore --verbosity normal --logger "trx;LogFileName=test-results.trx"
         env:
-          # Testcontainers will automatically use the Docker daemon
           TESTCONTAINERS_RYUK_DISABLED: false
 
       - name: Upload test results
         uses: actions/upload-artifact@v4
         if: always()
         with:
-          name: test-results-postgres-${{ strategy.job-index }}
+          name: test-results-sync-postgres-${{ strategy.job-index }}
+          path: '**/TestResults/*.trx'
+
+  # Gatekeeper API tests
+  gatekeeper-tests:
+    name: Gatekeeper Tests
+    runs-on: ubuntu-latest
+    needs: [build, changes]
+    if: needs.changes.outputs.gatekeeper == 'true'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Cache NuGet packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Restore
+        run: dotnet restore Gatekeeper/Gatekeeper.Api.Tests
+
+      - name: Test
+        run: dotnet test Gatekeeper/Gatekeeper.Api.Tests --no-restore --verbosity normal --logger "trx;LogFileName=test-results.trx"
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results-gatekeeper
+          path: '**/TestResults/*.trx'
+
+  # Sample API tests
+  sample-api-tests:
+    name: Sample API Tests
+    runs-on: ubuntu-latest
+    needs: [build, changes]
+    if: needs.changes.outputs.samples == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        project:
+          - Samples/Clinical/Clinical.Api.Tests
+          - Samples/Scheduling/Scheduling.Api.Tests
+          - Samples/Dashboard/Dashboard.Web.Tests
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            8.0.x
+            ${{ env.DOTNET_VERSION }}
+
+      - name: Restore .NET tools
+        run: dotnet tool restore
+
+      - name: Cache NuGet packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Restore
+        run: dotnet restore ${{ matrix.project }}
+
+      - name: Test
+        run: dotnet test ${{ matrix.project }} --no-restore --verbosity normal --logger "trx;LogFileName=test-results.trx"
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results-sample-api-${{ strategy.job-index }}
           path: '**/TestResults/*.trx'
 
   # Dashboard E2E tests (need Playwright browser)
   e2e-tests:
     name: Dashboard E2E Tests
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build, changes]
+    if: needs.changes.outputs.dashboard == 'true'
     steps:
       - uses: actions/checkout@v4