# Conventions

## Alphabetical ordering (enforced by CI)

All keys in `api/components/examples/*/requests/*.yaml` must be sorted alphabetically (case-insensitive) at the top level.

All `properties` keys in `api/components/schemas/requestBodies/**/*.yaml` must be sorted alphabetically (case-insensitive) at every nesting level.

To fix violations: `npm run yq:sort && npm run sort-properties`
To check: `npm run check-alphabetical`