add doc generation action

Author: baileympearson

.github/workflows/check-docs.yml

@@ -0,0 +1,88 @@
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch: {}
+  workflow_call: {}
+
+name: Build and Test
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  check_docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: node install --ignore-scripts
+
+      - name: Build and check docs
+        run: |
+            npm run docs
+            if ! git diff --quiet README.md ; then
+                echo "Generated readme is out-of-sync!  Please update the readme and re-commit, modifying the template in etc/README.hbs if necessary."
+                exit 1
+            fi
+
+  container_builds:
+    outputs:
+      artifact_id: ${{ steps.upload.outputs.artifact-id }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        linux_arch: [s390x, arm64, amd64]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Run Buildx
+        run: |
+          docker buildx create --name builder --bootstrap --use
+          docker buildx build --platform linux/${{ matrix.linux_arch }} --build-arg NODE_ARCH=${{ matrix.linux_arch == 'amd64' && 'x64' || matrix.linux_arch }} --output type=local,dest=./prebuilds,platform-split=false -f ./.github/docker/Dockerfile.glibc .
+
+      - id: upload
+        name: Upload prebuild
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-linux-${{ matrix.linux_arch }}
+          path: prebuilds/
+          if-no-files-found: 'error'
+          retention-days: 1
+          compression-level: 0
+
+  freebsd_builds:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        freebsd_arch: [aarch64, amd64]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build freebsd-${{ matrix.freebsd_arch }} Prebuild
+        uses: vmactions/freebsd-vm@v1
+        with:
+          arch: ${{ matrix.freebsd_arch }}
+          usesh: true
+          prepare: |
+            pkg install -y krb5 node npm pkgconf
+          run: |
+            node .github/scripts/build.mjs
+
+      - id: upload
+        name: Upload prebuild
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-freebsd-${{ matrix.freebsd_arch }}
+          path: prebuilds/
+          if-no-files-found: 'error'
+          retention-days: 1
+          compression-level: 0