add docc scripts and workflow

.doccTargetList

@@ -0,0 +1 @@
+Add one target per line

.github/workflows/docc_deploy.yml

@@ -0,0 +1,65 @@
+name: DocC Deploy
+
+on:
+  workflow_call:
+    inputs:
+      docc_swift_version:
+        type: string
+        description: "Swift version used to generate DocC documentation."
+        default: "6.2"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}-docc
+  cancel-in-progress: true
+
+
+jobs:
+
+  generate-docc:
+    name: Generate DocC documentation
+    runs-on: ubuntu-latest
+
+    container:
+      image: swift:${{ inputs.docc_swift_version }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install curl + jq
+        run: |
+          apt-get update -y
+          apt-get install -y curl jq
+
+      - name: Generate DocC documentation
+        run: |
+          curl -s https://raw.githubusercontent.com/BinaryBirds/github-workflows/refs/heads/feature/docc/scripts/generate-docc.sh | bash -s -- --name ${{ github.event.repository.name }}
+
+      - name: Upload DocC artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+
+  deploy:
+    name: Deploy DocC to GitHub Pages
+    needs: generate-docc
+    runs-on: ubuntu-latest
+
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

.github/workflows/extra_soundness.yml

@@ -7,14 +7,18 @@ on:
         type: boolean
         description: "Boolean to enable the local swift dependencies check job. Defaults to false."
         default: false
+      headers_check_enabled:
+        type: boolean
+        description: "Checks Swift source file headers to ensure they follow the correct format. Defaults to false."
+        default: false
       run_tests_with_cache_enabled:
         type: boolean
         description: "Boolean to enable run tests with .build cache."
         default: false
       run_tests_swift_versions:
         type: string
         description: "List of Swift versions to test with."
-        default: '["6.0", "6.1"]'
+        default: '["6.1", "6.2"]'
     secrets:
       SSH_PRIVATE_KEY:
         required: false
@@ -35,7 +39,22 @@ jobs:
         with:
           persist-credentials: false
       - name: Run local swift dependencies check
-        run: curl -s https://raw.githubusercontent.com/BinaryBirds/github-workflows/refs/heads/main/scripts/check-local-swift-dependencies.sh | bash
+        run: curl -s https://raw.githubusercontent.com/BinaryBirds/github-workflows/refs/heads/feature/docc/scripts/check-local-swift-dependencies.sh | bash
+
+
+  swift_headers_check:
+    name: Checks Swift source file headers
+    if: ${{ inputs.headers_check_enabled }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 1
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run swift headers check
+        run: curl -s https://raw.githubusercontent.com/BinaryBirds/github-workflows/refs/heads/feature/docc/scripts/check-swift-headers.sh | bash
+
 
   cache-and-test:
     name: Run tests with cache

LICENSE

@@ -1,6 +1,6 @@
-MIT License
+# MIT License
 
-Copyright (c) 2024 Binary Birds Ltd.
+Copyright (c) 2025 Binary Birds Ltd.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

Makefile

@@ -8,9 +8,20 @@ breakage:
 symlinks:
 	curl -s $(baseUrl)/check-broken-symlinks.sh | bash
 
+## params: --local: generate for local testing
+docc-generate:
+	curl -s $(baseUrl)/generate-docc.sh | bash
+
+docc-local:
+	curl -s $(baseUrl)/generate-docc.sh | bash -s -- --local
+
 docc-warnings:
 	curl -s $(baseUrl)/check-docc-warnings.sh | bash
 
+## params: -n: name, -p: port
+run-docc:
+	curl -s $(baseUrl)/run-docc-docker.sh | bash
+
 headers:
 	curl -s $(baseUrl)/check-swift-headers.sh | bash
 
@@ -52,4 +63,4 @@ lint:
 format:
 	curl -s $(baseUrl)/run-swift-format.sh | bash -s -- --fix 
 
-check: symlinks language deps lint
+check: symlinks language deps lint docc-warnings headers