Switch docs from jazzy to DocC (#399)

* WIP on migrating to docc

* Fix up links and theme-settings.json

* GHA doesn't seem to have Xcode 15 anymore

* Update GHA docs actions

* fix: Update GitHub Actions workflows for DocC migration

- Add CI environment detection to docs.sh script
- Use mkdocs directly in GitHub Actions instead of mkdocs-dev.sh
- Maintain backward compatibility for local development workflow

This resolves the CI failure where mkdocs-dev.sh expected a virtual
environment that doesn't exist in GitHub Actions runners, since
dependencies are installed globally in CI.

* macOS 26 is not yet on GitHub

* Unversion migration doc

* WIP on document, reviewing TripKitAPI

* Simplify project

* Fix up including additional docc content in docs

* Make couple of parameters of `TKRouter.fetchTripsResponse` optional; update docs

Author: nighthawk

.github/workflows/docs-dryrun.yml

@@ -2,7 +2,7 @@ name: Build docs
 
 on:
   pull_request:
-    branches: [ main ]
+    branches: [main]
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -21,14 +21,12 @@ jobs:
           python-version: 3.x
       - name: Prepare dependencies
         run: |
-          brew install sourcekitten
           python --version
           pip install --upgrade pip
           pip install mkdocs
           pip install pymdown-extensions
           pip install git+https://github.com/skedgo/skedgo-mkdocs-theme
-          mkdocs --version 
-          bundle install
+          mkdocs --version
 
       - name: Build docs
         run: |

.github/workflows/docs.yml

@@ -2,7 +2,7 @@ name: Deploy docs
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -21,14 +21,12 @@ jobs:
           python-version: 3.x
       - name: Prepare dependencies
         run: |
-          brew install sourcekitten
           python --version
           pip install --upgrade pip
           pip install mkdocs
-          pip install pymdown-extensions    
+          pip install pymdown-extensions
           pip install git+https://github.com/skedgo/skedgo-mkdocs-theme
-          mkdocs --version 
-          bundle install
+          mkdocs --version
 
       - name: Build docs
         run: |

.github/workflows/swift.yml

@@ -4,33 +4,31 @@ on:
   push:
     branches: [main]
     paths:
-      - 'Sources/**'
-      - 'Tests/**'
-      - 'Package.swift'
-      - 'TripKit.xcodeproj/**'
-      - 'Examples/**'
+      - "Sources/**"
+      - "Tests/**"
+      - "Package.swift"
+      - "TripKit.xcodeproj/**"
+      - "Examples/**"
   pull_request:
     paths:
-      - 'Sources/**'
-      - 'Tests/**'
-      - 'Package.swift'
-      - 'TripKit.xcodeproj/**'
-      - 'Examples/**'
+      - "Sources/**"
+      - "Tests/**"
+      - "Package.swift"
+      - "TripKit.xcodeproj/**"
+      - "Examples/**"
   workflow_dispatch:
 
 jobs:
   build_spm:
     strategy:
       matrix:
         include:
+          # - os: macos-26
+          #   xcode: "26.0"
           - os: macos-15
-            xcode: '16.2'
-          - os: macos-15
-            xcode: '15.4'
-          - os: macos-14
-            xcode: '16.1' # sic, 16.2 not available on GitHub as of Jan 2025
+            xcode: "16.4"
           - os: macos-14
-            xcode: '15.4'
+            xcode: "16.1" # sic, 16.2 not available on GitHub as of Jan 2025
 
     runs-on: ${{ matrix.os }}
 
@@ -49,13 +47,13 @@ jobs:
       matrix:
         swift: ["6.0", "5.10"]
     container:
-      image: swift:${{ matrix.swift }}  
+      image: swift:${{ matrix.swift }}
 
     steps:
       - uses: actions/checkout@v4
       - name: Build
-        run: swift build --target TripKitAPI      
-      
+        run: swift build --target TripKitAPI
+
   build_xcode:
     runs-on: macos-15
 

.gitignore

@@ -34,5 +34,8 @@ TripKit.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved
 /Scripts/docs/source/TripKit
 /Scripts/docs/source/TripKitUI
 /Scripts/docs/source/TripKitInterApp
+/Scripts/docs/source/sdk
 /Scripts/docs/site
-/public
+/docc_archives/
+
+/public