Skip to content

Instantly share code, notes, and snippets.

@oicaroabreu
oicaroabreu / melhores-praticas.md
Last active October 4, 2023 13:39
Melhores Práticas

Melhores Práticas

1. Documentação Adequada

Manter uma documentação adequada é fundamental para facilitar a manutenção do código da equipe como um todo. Isso inclui:

  • Documentação de código com comentários significativos: Comentários no código devem ser informativos e explicar o que o código faz, a lógica por trás dele e quaisquer considerações especiais. Seguindo o padrão de idioma do código: língua inglesa.

    Dica: use o ChatGPT para gerar Docstrings

  • Guias de instalação e uso: Forneça instruções claras sobre como configurar o ambiente de desenvolvimento, instalar dependências e executar o software. Isso ajuda novos membros da equipe a se integrarem mais rapidamente.