# Páginas bilíngues

## Escreva cada página duas vezes

A documentação publica toda página em inglês e em português do Brasil. O inglês é a fonte da verdade. Escreva a página em português sobre a página em inglês pronta, não em paralelo com ela. A estrutura da página em português segue a página em inglês, e uma mudança na página em inglês cria trabalho correspondente na página em português.

Para escrever ou atualizar uma página em português, abra primeiro a página em inglês. Se a página em inglês não existe, escreva-a primeiro: uma página em português escrita primeiro não tem fonte, e a página em inglês que vier depois vira uma tradução de uma tradução.

## Vincule as versões pelo namespace

O site vincula as duas versões de uma página pelo campo `namespace`, não pelo caminho do arquivo. O seletor de idioma depende desse vínculo. Os dois arquivos carregam o mesmo valor, caractere por caractere:

```
en:     title:     Create an Object Storage bucket
        permalink: /documentation/guides/application-development/data/create-and-modify-bucket/
        namespace: documentation_products_object_storage_bucket

pt-br:  title:     Criar um bucket do Object Storage
        permalink: /documentacao/guias/desenvolvimento-de-aplicacoes/dados/criar-e-modificar-um-bucket/
        namespace: documentation_products_object_storage_bucket
```

Cada campo do frontmatter segue uma de três regras na página em português:

| Campo         | Página em português      |
| ------------- | ------------------------ |
| `title`       | traduzido                |
| `description` | traduzida                |
| `permalink`   | traduzido                |
| `namespace`   | idêntico ao inglês       |
| `meta_tags`   | por convenção, em inglês |

Um namespace diferente entre as versões quebra o seletor de idioma, e o build passa mesmo assim. Nada avisa; confira o valor caractere por caractere antes de publicar. As regras de cada campo estão em [Frontmatter](/pt-br/documentacao/guia-de-estilo/convencoes/frontmatter/).

## Localize diretórios e permalinks

Localize os nomes de diretórios e de arquivos; não copie a árvore em inglês. `guides/` vira `guias/`, e `create-bucket.mdx` vira `criar-bucket.mdx`. Os permalinks seguem a mesma regra: `/documentation/products/...` vira `/documentacao/produtos/...`.

Os permalinks ficam em ASCII nos dois idiomas. Remova os acentos em vez de codificá-los: `configuracao`, não `configuração`.

## Use o prefixo de idioma correto nos links

Links internos são absolutos, começam com um prefixo de idioma e terminam com barra. O mesmo link muda só o prefixo entre as duas versões:

```
Página em inglês:    [Applications](/en/documentation/platform/applications/)
Página em português: [Applications](/pt-br/documentacao/plataforma/applications/)
```

Uma página em português aponta para uma página em inglês só quando a tradução não existe. Nunca envie o leitor para o inglês quando a página em português existe.

## Escreva o inglês para sobreviver à tradução

A página em inglês define a tarefa de quem traduz. Uma frase curta traduz um para um. Uma frase de 45 palavras com três orações subordinadas força quem traduz a reestruturá-la, e a reestruturação é onde o sentido se perde.

As regras estruturais de [Estrutura de frases](/pt-br/documentacao/guia-de-estilo/escrita/estrutura-de-frases/) valem para o português sem mudança. Limite de tamanho de frase, uma instrução por passo, tempos verbais simples, voz ativa e agrupamentos curtos de substantivos: tudo se transfere. As regras de vocabulário não se transferem; o vocabulário do português está em [Terminologia da documentação](/pt-br/documentacao/guia-de-estilo/escrita/terminologia/).

## Aplique as regras de tradução

Cinco regras cobrem a maior parte do trabalho em uma página em português:

- Não traduza termos técnicos genéricos: `data center`, `serverless`, `template`, `compliance`, `on-premise`. As strings `edge` e `edge computing` permanecem sem tradução onde já aparecem, mas textos novos não as introduzem.
- Não traduza nomes de produto: **Applications**, **Functions**, **Firewall**, **Azion Platform**, **Azion Marketplace**.
- Aplique as substituições: `aplicação`, não `aplicativo`; `rede distribuída`, não `borda`, ao traduzir texto existente; `performance`, não `desempenho`. Texto novo em português que nomeia onde a plataforma roda escreve `infraestrutura distribuída`.
- Escreva títulos com maiúscula só na primeira palavra e nos nomes próprios.
- Localize os rótulos dos asides: `:::note[nota]`, `:::tip[dica]`, `:::caution[Atenção]`. Um rótulo em inglês em uma página em português é um defeito visível.

A lista completa de termos que ficam em inglês está em [Terminologia da documentação](/pt-br/documentacao/guia-de-estilo/escrita/terminologia/).

## Use as formas fixas em português

Três elementos recorrentes se traduzem sempre da mesma forma. Não improvise uma forma nova para eles.

Três nomes de seção têm forma fixa em português:

- `## Prerequisites` vira `## Pré-requisitos`.
- `## Next steps` vira `## Próximos passos`.
- `## Related resources` vira `## Recursos relacionados`.

As frases padrão de link têm forma fixa, e o verbo é `consulte`:

- `Para mais informações, consulte [Título](/pt-br/.../).`
- `Para <fazer algo>, consulte [Título](/pt-br/.../).`

Os rótulos da interface do Console ficam como a interface mostra. Não traduza nomes de botões e campos que o Console exibe em inglês: **Save**, **Workloads Access**, **+ Bucket**.

## Revise toda tradução

Nunca publique uma tradução automática sem revisão. Uma tradução errada é mais difícil de achar e corrigir do que uma tradução ausente, porque a página parece completa. Use tradução automática só como primeiro rascunho, e revise o rascunho antes de publicar.