feat(docs): add built-in help section with How-To guides embedded in app

- Add MkDocs Material docs build stage to Dockerfile and Dockerfile.local
- Mount pre-built docs as static files at /help/ in FastAPI (app/main.py)
- Add app/views/help.py with /help → /help/ permanent redirect route
- Register help router in app/views/__init__.py
- Add Help nav link to base.html (public + app nav, desktop + mobile)
- Create how-to guides: HP printer, ScanSnap, watched folder, email ingestion, mobile scanning
- Update mkdocs.yml with How-To Guides section and Material theme palette
- Add optional docs service (squidfunk/mkdocs-material) to docker-compose.yaml with docs profile
- Add mkdocs-material to requirements-dev.txt
- Add /docs_build to .gitignore
- Add tests for help view (8 tests, 100% coverage on help.py)

Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>

app/main.py

@@ -202,6 +202,15 @@ if os.path.exists(static_dir):
 else:
     print(f"WARNING: Static directory not found at {static_dir}. Static files will not be served.")
 
+# Mount the built MkDocs documentation site at /help/
+# The docs are pre-built into docs_build/ during the Docker image build.
+# When running locally, run `mkdocs build` from the repo root first.
+docs_build_dir = pathlib.Path(__file__).parents[1] / "docs_build"
+if os.path.exists(docs_build_dir):
+    app.mount("/help", StaticFiles(directory=str(docs_build_dir), html=True), name="help_docs")
+else:
+    print(f"INFO: Help docs not found at {docs_build_dir}. Run 'mkdocs build' to generate them.")
+
 
 # Custom exception handlers that return JSON for API routes and HTML for frontend routes
 @app.exception_handler(HTTPException)

app/views/__init__.py

@@ -12,6 +12,7 @@ from app.views.filemanager import router as filemanager_router
 # Import all the view routers
 from app.views.general import router as general_router
 from app.views.google_drive import router as google_drive_router
+from app.views.help import router as help_router  # Built-in help / How-To docs
 from app.views.license_routes import router as license_router  # Add the license router
 from app.views.onboarding import router as onboarding_router
 from app.views.onedrive import router as onedrive_router
@@ -43,3 +44,4 @@ router.include_router(subscriptions_router)  # Pricing + subscription pages
 router.include_router(plans_router)  # Admin Plan Designer
 router.include_router(onboarding_router)  # User onboarding wizard
 router.include_router(pipelines_router)  # Processing pipelines
+router.include_router(help_router)  # Built-in help / How-To docs

app/views/help.py

@@ -0,0 +1,27 @@
+"""
+Help documentation view routes.
+
+Serves the built MkDocs documentation site at /help.
+The static site is built during the Docker image build and placed at docs_build/.
+"""
+
+import logging
+import pathlib
+
+from fastapi import Request
+from fastapi.responses import RedirectResponse
+
+from app.views.base import APIRouter
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter()
+
+# Path to the built MkDocs documentation
+_DOCS_BUILD_DIR = pathlib.Path(__file__).parents[2] / "docs_build"
+
+
+@router.get("/help", include_in_schema=False)
+async def help_redirect(request: Request) -> RedirectResponse:
+    """Redirect /help to /help/ so the MkDocs index is served correctly."""
+    return RedirectResponse(url="/help/", status_code=301)