bunker-admin 68ba45a689 Documentation editorial: Material theme hardening, metadata, and content polish
- Enable navigation.instant, prefetch, progress, content.code.select, content.tabs.link
- Fix edit_uri (main→v2), copyright year (2024→2024-2026), consent banner config
- Add abbreviations glossary (47 acronyms with hover tooltips via snippets auto-append)
- Add tags to all 72 doc pages with consistent taxonomy (audience/module/type)
- Add status:new badges to 16 recent feature pages, search:boost to 7 entry pages
- Rewrite Architecture page with 5 Mermaid diagrams and full component documentation
- Rewrite Troubleshooting page from 5 to 13 sections with actionable checklists
- Fix broken links (Monitoring/Contributing pointed to blog placeholder)
- Expand Admin Guide roles table from 5 to 11 roles
- Create custom 404 page, blog with authors and inaugural v2 announcement post
- Fresh Playwright screenshots for login, dashboard, campaigns, users, settings, locations, shifts
- Remove 5 test/dev files and orphan template override
- Add planning document (DOCS_NEXT_STEPS.md) for future editorial reference

Bunker Admin
2026-03-23 12:36:10 -06:00

1.8 KiB

title, description, icon, tags
title description icon tags
Documentation MkDocs site management, page analytics, comment moderation, and documentation settings. material/book-open-variant
guide
admin
content

Documentation

Manage the MkDocs documentation site, track page engagement, and moderate visitor comments.


MkDocs Management

From Docs (/app/docs):

  • View MkDocs build status and health
  • Browse the documentation file tree
  • Export landing pages to MkDocs as Jinja2 Material theme overrides
  • Configure documentation settings from MkDocs Settings (/app/docs/settings)

Documentation Analytics

Track how visitors interact with documentation pages using the MkDocs Material theme's custom analytics provider and navigation.tracking.

  • Navigation tracking — updates the browser URL as users scroll through sections, enabling section-level engagement tracking
  • Custom provider — integrates with any third-party analytics tool (Plausible, Umami, Google Analytics) via template overrides in docs/overrides/

Comments

Visitors can leave comments on documentation pages using a Gitea-backed comment system.

  • Anonymous posting — visitors can comment without creating an account
  • Gitea-backed — comments stored as Gitea issues (one issue per page) for version control and searchability
  • Moderation — admin panel at /app/docs-comments for approving, hiding, or deleting comments
  • OAuth login — optional Gitea OAuth for authenticated commenting
  • Per-page threads — each documentation page gets its own comment thread

Admin Routes

  • /app/docs — MkDocs management (file tree, config, build triggers)
  • /app/docs/settings — documentation configuration
  • /app/docs-comments — moderate documentation comments