# Style Guide

Este guia descreve como a Azion escreve sua documentação. Use este guia quando você escrever uma página nova, traduzir uma página ou revisar o trabalho de outra pessoa. As regras existem para que todas as páginas tenham a mesma leitura, sejam bem traduzidas e continuem úteis quando uma máquina recupera uma seção sozinha.

## O que este guia cobre

- [Voz da documentação](/pt-br/documentacao/guia-de-estilo/escrita/voz/): o registro que todas as páginas usam.
- [Estrutura de frases](/pt-br/documentacao/guia-de-estilo/escrita/estrutura-de-frases/): as regras de frase, adaptadas do ASD-STE100.
- [Procedimentos](/pt-br/documentacao/guia-de-estilo/escrita/procedimentos/): a gramática de passo que todo procedimento numerado segue.
- [Escolha de palavras](/pt-br/documentacao/guia-de-estilo/escrita/escolha-de-palavras/): o vocabulário a evitar e os padrões de enchimento a cortar.
- [Terminologia da documentação](/pt-br/documentacao/guia-de-estilo/escrita/terminologia/): nomes de produtos, os quatro termos da plataforma e regras de tradução.
- [Títulos](/pt-br/documentacao/guia-de-estilo/formatacao/titulos/), [formatação de texto](/pt-br/documentacao/guia-de-estilo/formatacao/texto/), [código](/pt-br/documentacao/guia-de-estilo/formatacao/codigo/), [pontuação](/pt-br/documentacao/guia-de-estilo/formatacao/pontuacao/) e [números e unidades](/pt-br/documentacao/guia-de-estilo/formatacao/numeros/): como o conteúdo é formatado.
- [Estrutura de conteúdo](/pt-br/documentacao/guia-de-estilo/conteudo/escolher-um-tipo-de-conteudo/): os tipos de página e como escolher um, incluindo [quickstarts](/pt-br/documentacao/guia-de-estilo/conteudo/quickstart/) e [casos de uso](/pt-br/documentacao/guia-de-estilo/conteudo/casos-de-uso/).
- [Arquitetura de informação](/pt-br/documentacao/guia-de-estilo/conteudo/arquitetura-de-informacao/): os treze slots que uma seção de produto pode preencher, na ordem em que o leitor os encontra.
- [Convenções de arquivos](/pt-br/documentacao/guia-de-estilo/convencoes/frontmatter/): frontmatter e [páginas bilíngues](/pt-br/documentacao/guia-de-estilo/convencoes/paginas-bilingues/).
- [Componentes](/pt-br/documentacao/guia-de-estilo/componentes/): o conjunto de componentes MDX ativos e as regras de cada um.
- [Como escrevemos a documentação](/pt-br/documentacao/guia-de-estilo/como-documentamos/): como a documentação é produzida, em dois idiomas, para pessoas e agentes.

## O guia segue as próprias regras

Todas as páginas desta seção passam pelas regras que descrevem: os limites de frase, as regras de títulos e as metas de tamanho. Quando uma regra não funciona aqui, a regra muda antes de qualquer pessoa precisar segui-la.