Vocs best practices

Use when building or reviewing documentation sites with Vocs.

Mental model

• Vocs is a minimal React documentation framework powered by Vite.
• Keep the docs architecture simple and content-first; Vocs is strongest when the site remains lightweight, static-friendly, and easy to maintain.
• Treat Vocs configuration as application code that should stay readable and intentional.

Project shape

• Keep content structure predictable so navigation, linking, and long-term maintenance stay easy.
• Prefer simple, explicit doc hierarchies over clever nesting or many competing entrypoints.
• Separate docs content, theme customization, and custom components so ownership is clear.

Config and theming