docs: publish only docs/public to GitHub Pages

.github/workflows/publish-docs.yml

@@ -44,9 +44,21 @@ jobs:
           chmod +x scripts/docs/*.sh
           scripts/docs/generate-all.sh
 
-      - name: Build MkDocs site
+      - name: Build public MkDocs site
         run: |
-          python3 -m mkdocs build --strict
+          python3 -m mkdocs build -f mkdocs-public.yml --strict
+
+      - name: Verify published content excludes internal/generated docs
+        run: |
+          test -d site-public
+          test ! -e site-public/generated
+          test ! -e site-public/docker
+
+      - name: Verify expected 404-only paths are not generated
+        run: |
+          test ! -e site-public/generated/compose-inventory/index.html
+          test ! -e site-public/generated/prometheus-rules/index.html
+          test ! -e site-public/docker/index.html
 
       - name: Configure GitHub Pages
         uses: actions/configure-pages@v5
@@ -54,7 +66,7 @@ jobs:
       - name: Upload GitHub Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: site
+          path: site-public
 
   deploy:
     runs-on: ubuntu-latest