Skip to main content

Sobre os conceitos básicos da documentação do GitHub

Todo o conteúdo publicado no GitHub Docs deve atender a esses requisitos fundamentais.

Sobre os conceitos básicos da documentação do GitHub

Esses conceitos básicos são necessários para a documentação do GitHub. Use as listas abaixo para ajudar a garantir que suas contribuições sejam precisas, acessíveis, inclusivas e consistentes.

Precisos

A documentação está correta e precisa.

  • Verifique se o conteúdo está livre de erros factuais.
  • Verifique se o conteúdo está livre de erros de ortografia e formatação.

Acessível e inclusivo

A documentação está atualizada com os padrões de acessibilidade mais recentes e foi escrita de modo a ser inclusiva e amigável à tradução.

Consistente

A documentação mantém uma voz, um tom e um estilo consistentes a todo momento, criando uma experiência coesa para os leitores.

  • Verifique se o conteúdo segue o guia de estilo do GitHub Docs. Para saber mais, confira Guia de estilo.
  • Aplique convenções de nomenclatura e terminologia consistentes.
  • Use elementos de identidade visual (por exemplo, nomes de produtos e recursos, logotipos, esquemas de cores) consistentemente no conteúdo.