Skip to content

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 ​

ParameterValue
Source directoryrepository root
Build commandnpm run build
Output directorybuild
Production branchmain
URLhttps://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 serve

Deployment 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 host

Configuration files ​

FilePurpose
static/_headersCloudflare cache policy
static/_redirectsLegacy MkDocs URL redirects
.vitepress/config.mtsSite configuration
.vitepress/navigation.tsSidebar 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 URLNew 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/

Internal developer documentation for Menzzo systems.