Skip to main content

​
Internacionalização

A documentação do Switchbord está sendo preparada para a mesma cobertura de locales do app e do site de marketing: inglês, italiano, espanhol, alemão, francês, português e chinês. O conteúdo público atual da documentação permanece em inglês enquanto a árvore de documentação localizada é gerada e revisada. O site de docs agora trata a localização como uma superfície de documentação explícita, de modo que a navegação do Mintlify, a paridade de páginas e a revisão de tradução possam ser auditadas junto com o trabalho de i18n da aplicação.

​
Plano de locales

  • en é o locale de origem.
  • it, es, de, fr, pt e zh são os locales de destino.
  • Os docs localizados devem preservar blocos de código, caminhos de API, nomes de variáveis de ambiente, nomes de produto e a sintaxe de componentes MDX.
  • Os links internos nos docs localizados devem permanecer dentro do locale selecionado, uma vez geradas as pastas de locale.

​
Critérios de qualidade

Antes de publicar os docs localizados, cada locale de destino precisa passar por:
  1. Paridade de páginas entre origem e destino em relação à árvore em inglês.
  2. Paridade de frontmatter para title e description.
  3. Validação do Mintlify.
  4. Verificação de links quebrados para cada árvore de locale.
  5. Revisão humana para páginas jurídicas, de segurança e de referência de API.

​
Nota de implementação

O conteúdo do app e de marketing é gerenciado por meio de pacotes de mensagens em JSON e do Languine. Os docs são MDX e exigem um fluxo de tradução seguro para MDX, que preserve blocos de código, links e tags de componentes.