- Use title case for the sidebar and H1, use sentence case for H2s and below
- Use active voice and second person ("you")
- Write for a technical, software developer audience
- Use contractions ("you're", "won't")
- Use bold formatting (example) when referencing UI elements and backticks for
inline code. - Give the user clear recommendations and next steps when possible
- To indicate required or optional user actions or the outcomes of a process, select an appropriate verb—for example, "must", "can", or "might"; avoid "should"
- Give clear recommendations and explain the 'why', not just the 'what'; if unclear, ask for clarification
- Don't use the word "please"
- Ensure there's a TypeScript/Javascript version and a Python version
- Use real-world parameter values in examples, not placeholders
This is a fumadocs (Next.js) documentation site. Content lives in content/docs/ as MDX.
- Run the docs site:
bun dev(serves onhttp://localhost:3000) - Lint/build:
bun run buildcompiles every page;bun run lintruns Biome. Validate changes with a build. - Config:
docs.jsonremains the navigation source of truth (tabs/groups/redirects);lib/tree.tsconverts it to the sidebar at build time. Mintlify components (<Info>,<CodeGroup>,<Steps>, ...) still work — they're aliased incomponents/mdx.tsx.