- 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
1.8 KiB
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 |
|
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-commentsfor 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