Merge branch 'main' into codex/refactor-docs-pipeline-for-local-generation

.github/workflows/publish-docs.yml

@@ -34,7 +34,23 @@ jobs:
 
       - name: Build public MkDocs site
         run: |
+<<<<<<< codex/refactor-docs-pipeline-for-local-generation
           python3 -m mkdocs build --strict -f mkdocs-public.yml -d site-public
+=======
+          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
+>>>>>>> main
 
       - name: Configure GitHub Pages
         uses: actions/configure-pages@v5

mkdocs-public.yml

@@ -1,7 +1,9 @@
 site_name: Public Infrastructure Documentation
-site_description: Sanitized public documentation generated and committed from the docker host
+site_description: Public-facing infrastructure documentation
 repo_url: https://github.com/beatz174-bit/docker
+site_url: https://beatz174-bit.github.io/docker/
 docs_dir: docs/public
+site_dir: site-public
 
 nav:
   - Home: index.md
@@ -11,3 +13,7 @@ nav:
 
 theme:
   name: mkdocs
+
+validation:
+  nav:
+    omitted_files: ignore