diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 4d6518c..de137d1 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -170,31 +170,7 @@ jobs:
         run: |
           cosign sign --yes "${REGISTRY}/${{ steps.img.outputs.name }}@${{ steps.build.outputs.digest }}"
 
-  update-docs:
-    name: Update Documentation
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: '20'
-          cache: 'npm'
-          cache-dependency-path: docs/package-lock.json
-
-      - name: Install dependencies
-        working-directory: docs
-        run: npm ci
-
-      - name: Build documentation
-        working-directory: docs
-        run: npm run build
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/build
+  # Docs deployment lives in docs.yml (Astro -> docs/dist, official Pages
+  # flow), which already runs on docs/** pushes. The job that used to live
+  # here pointed at ./docs/build (wrong for Astro) and duplicated docs.yml,
+  # so it was removed rather than fixed.