# Style Guide

This guide describes how Azion writes its documentation. Use it when you write a new page, translate one, or review someone else's work. The rules exist so that every page reads the same way, translates well, and stays useful when a machine retrieves one section alone.

## What this guide covers

- [Documentation voice](/en/documentation/style-guide/writing/voice/): the register every page uses.
- [Sentence structure](/en/documentation/style-guide/writing/sentence-structure/): the sentence rules, adapted from ASD-STE100.
- [Procedures](/en/documentation/style-guide/writing/procedures/): the step grammar every numbered procedure follows.
- [Word choice](/en/documentation/style-guide/writing/word-choice/): the vocabulary to avoid and the padding patterns to cut.
- [Documentation terminology](/en/documentation/style-guide/writing/terminology/): product names, the four platform terms, and translation rules.
- [Headings](/en/documentation/style-guide/formatting/headings/), [text formatting](/en/documentation/style-guide/formatting/text/), [code](/en/documentation/style-guide/formatting/code/), [punctuation](/en/documentation/style-guide/formatting/punctuation/), and [numbers and units](/en/documentation/style-guide/formatting/numbers/): how content is formatted.
- [Content structure](/en/documentation/style-guide/content/choose-a-content-type/): the page kinds and how to pick one, including [quickstarts](/en/documentation/style-guide/content/quickstart/) and [use cases](/en/documentation/style-guide/content/use-cases/).
- [Information architecture](/en/documentation/style-guide/content/information-architecture/): the thirteen slots a product section can fill, in the order the reader meets them.
- [File conventions](/en/documentation/style-guide/conventions/frontmatter/): frontmatter and [bilingual pages](/en/documentation/style-guide/conventions/bilingual/).
- [Components](/en/documentation/style-guide/components/): the live MDX component set and the rules each one carries.
- [How we write the docs](/en/documentation/style-guide/how-we-docs/): how the documentation is produced, in two languages, for people and agents.

## The guide follows its own rules

Every page in this section passes the rules it describes: the sentence caps, the heading rules, and the size targets. When a rule proves unworkable here, the rule changes before any writer is asked to follow it.