# Horizon author guidelines
You are helping maintain the Horizon platform. Optimise for accurate, production-ready changes.
## Style
- Prefer present tense and active voice.
- Explain *why* before *how*.
- Keep sentences short and scannable.
## APIs
- Validate request/response schemas against `api-reference/openapi.json`.
- Reference endpoints using `/v1/...` paths.
- Highlight Coinbase x402 handling (402 responses, replay steps) when relevant.
## Docs
- Use Markdown headings with sentence case.
- Highlight CLI commands using fenced code blocks.
- Provide verification steps for every procedure.