Appearance
Docs Site Deployment
The documentation site is built with VitePress from the global axelites/menzzo-docs repository. Historical configuration described Cloudflare Pages Git integration; the actual deployment behind menzzo-docs.trydev.ovh remains unverified. See the shared deployment runbook before publishing.
Cloudflare Pages configuration
| Parameter | Value |
|---|---|
| Source directory | repository root |
| Build command | npm run build |
| Output directory | build |
| Production branch | main |
| URL | https://menzzo-docs.pages.dev |
Local development
bash
cd docs
# Install dependencies
npm ci
# Start the development server (hot reload)
npm start
# Production build
npm run build
# Preview the build
npm run serveDeployment process
Historically, the documented setup deployed main to production and feature branches to previews. Confirm the real pipeline before any push: these actions can trigger production and require the identity and approval checks in the shared runbook. A rollback must target the verified host and retain the previous artifact and routing rules.
Manual deployment (fallback)
bash
cd docs
npm run build
# The contents of build/ can be served by any static hostConfiguration files
| File | Purpose |
|---|---|
static/_headers | Cloudflare cache policy |
static/_redirects | Legacy MkDocs URL redirects |
.vitepress/config.mts | Site configuration |
.vitepress/navigation.ts | Sidebar navigation structure |
Migration from MkDocs
The original MkDocs content was imported into Docusaurus and is now preserved in VitePress. Source Markdown remains in content/, including legacy references. The current site uses Vue, local search and Mermaid; it no longer requires the Docusaurus/React build pipeline.
Historical links remain a migration acceptance requirement. Local output validation and browser checks are separate from verifying the host's redirect behavior.
Legacy URLs
The table shows representative MkDocs redirects. The repository-root static/_redirects file contains the complete rules, including moved-page wildcards and search/blog compatibility paths:
| Old URL | New URL |
|---|---|
/operations/sales-import-workflow/ | /docs/projects/logidav/workflows/sales-import |
/cronjobs/ | /docs/projects/logidav/reference/cronjobs/ |
/integrations/ | /docs/projects/logidav/integrations/ |
/development/ | /docs/projects/logidav/getting-started/ |