Skip to content

Latest commit

 

History

History
58 lines (32 loc) · 3.43 KB

CONTRIBUTING.md

File metadata and controls

58 lines (32 loc) · 3.43 KB
Raw

Contribuindo com o Shipment-sdk-php - Melhor Envio

Contribuições são bem-vindas e serão dados os devidos créditos.

Ajude a manter o Shipment-sdk-php do Melhor Envio aberto e inclusivo.

Por favor leia e entenda o guia de contribuição antes de criar uma issue ou pull request.

Etiqueta

Este projeto é código aberto e como tal, nossa equipe se dedica sempre para criar e manter o código fonte funcionando. Disponibilizamos o código gratuitamente na esperança que seja útil para outros desenvolvedores. Seria extremamento injusto se sofressemos com abuso ou raiva pelo empenho no nosso trabalho.

Seja atencioso com nossa equipe ao levantar problemas e fazer pull requets. Assim podemos mostrar ao mundo que desenvolvedores são pessoas civilizadas e altruístas.

É dever do desenvolvedor responsável pelo projeto, garantir que todos os pull requests tenham qualidade suficiente para beneficar o projeto. Muitos desenvolvendores possuem habilidades diferentes, fortes e fracas. Portanto não fique chateado(a), se seu pull request não for utilizado no projeto.

Viabilidade

Ao submeter novas features, primeiro considere se será útil para outras pessoas. Projetos open Source são usados por muitos desenvolvedores, que podem ter necessidades muito diferentes das suas. Verifique se sua feature será usado ou não por outros usuários do projeto.

Procedimento

Antes de registrar um problema:

  • Tente replicar o problema, para garantir que não foi um incidente coincidente.
  • Verifique se a sugestão da sua feature ainda não está presente no projeto.
  • Verfique a lista de pull requests para garantir que o bug não tenha nenhuma correção em andamento.
  • Verifique a lista de pull requests para garantir que a feature não está em andamento.

Antes de fazer um pull request:

  • Verifique o código base para garantir que sua feature ainda não exista.
  • Verifique a lista de pull requests para garantir que outra pessoa ainda não tenha enviado a feature ou fix.

Requisitos

Se os desenvolvedores do projeto tiverem requisitos adicionais, você encontrará listados a seguir:

  • PSR-2 Coding Standard - A maneira mais fácil de aplicar essas convenções, é instalar o PHP Code Sniffer.

  • Adicione testes! - Seu pacote não será aceito se não tiver testes.

  • Documente qualquer mudança de comportamento do pacote. - Verifique se o README.md e qualquer outra documentação relevante estão atualizados.

  • Considere o nosso ciclo de lançamento - Nós tentamos seguir o SemVer v2.0.0. Quebrar APIs públicas aleatóriamente não é uma opção.

  • Um pull request por feature - Se você quiser fazer mais de uma contribuição, envie mais pull requests.

  • Enviar histório coerente - Verifique se cada commit em seu pull request é significativo. Se você fizer vários commits intermediários enquanto desenvolve a feature ou fix, por favor destrua-os antes de submeter.

Bom desenvolvimento e programe com responsabilidade, atenciosamente, Melhor Envio - Time de tecnologia.