Maintaining this site

For Harold staff: how this documentation repository is structured, how it ships independently from the production app, and editorial expectations.

Internal notes for contributors — customer-facing tone still applies in every paragraph.

Repository layout

docs-site

This site is a standalone Next.js app under docs-site. It deploys independently from production Harold so documentation can ship on its own cadence.

Touch points

Catalog: lib/doc-catalog.ts
Bodies: content/doc-pages/*.tsx
Shared blocks: components/doc-blocks.tsx

Publishing cadence

Tone & safety

Prefer

Operational language.
Measurable claims.
Explicit “no action required” when true.

Avoid

Detail that helps attackers or competitors.
Speculation about unreleased features.
Dumping raw stack traces into public pages.

Was this page helpful?