---
title: Documentation conventions
description: Lightweight guidance for documentation conventions and source-of-truth references.
---

# Conventions

Use this reference as the lightweight entry point for documentation conventions.
For the detailed source of truth, follow the repository instructions:

- `.github/instructions/hve-core/markdown.instructions.md`
- `.github/instructions/hve-core/writing-style.instructions.md`
- `.github/instructions/docusaurus-edits.instructions.md`

## Practical checklist

- Prefer concise, direct prose with short sections and clear headings.
- Keep examples and commands accurate for the current repository layout.
- Use consistent terminology and avoid vague qualifiers.
- For Docusaurus content, preserve page structure and frontmatter expectations.
- When the task is a documentation rewrite or clarification, stay focused on factual
  accuracy rather than stylistic preference.
