Skip to content

Latest commit

 

History

History
56 lines (34 loc) · 3.04 KB

CONTRIBUTING.md

File metadata and controls

56 lines (34 loc) · 3.04 KB

Contribuir

As contribuições são bem-vindas e serão totalmente creditadas.

Leia e compreenda o guia de contribuição antes de abrir uma issue ou submeter uma PR.

Etiqueta

Este projeto é de código aberto e, como tal, os mantenedores dedicam seu tempo livre para criar e manter o código-fonte. Eles disponibilizam o código gratuitamente na esperança de que seja útil para outros desenvolvedores. Seria extremamente injusto que sofram abuso ou constrangimento por seu trabalho duro.

Seja atencioso com os mantenedores ao abrir issues ou submeter PRs. Vamos mostrar ao mundo em que os desenvolvedores são pessoas civilizadas e altruístas.

É dever do mantenedor garantir que todos os envios ao projeto sejam de qualidade para beneficiar o projeto. Muitos desenvolvedores têm diferentes habilidades, pontos fortes e fracos. Respeite a decisão do mantenedor e não fique chateado se a sua PR for recusada.

Viabilidade

Ao solicitar ou enviar novos recursos, primeiro considere se pode ser útil para outras pessoas. Os projetos de origem são usados ​​por muitos desenvolvedores, que podem ter necessidades totalmente diferentes das suas. Pense se seu recurso será usado 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 de recurso ainda não está presente no projeto.
  • Verifique a guia de PRs para garantir que o bug não tenha uma correção em andamento.
  • Verifique a guia de PRs para garantir que o recurso ainda não esteja em andamento.

Antes de enviar uma solicitação de recebimento:

  • Verifique a base de código para garantir que seu recurso ainda não existe.
  • Verifique as PRs para garantir que outra pessoa ainda não tenha enviado o recurso ou a correção.

Requisitos

Se o mantenedor do projeto tiver requisitos adicionais, você os encontrará listados aqui.

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

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

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

  • Considere nosso ciclo de lançamento - Tentamos seguir o SemVer v2.0.0. Quebrar APIs públicas aleatoriamente não é uma opção.

  • Uma solicitação de recebimento por recurso - Se você quiser fazer mais de uma coisa, envie várias solicitações de recebimento.

  • Enviar histórico coerente - Verifique se cada commit individual em sua PR é significativo. Se você precisou fazer vários commits intermediários durante o desenvolvimento, por favor envie em um só antes de enviar uma PR.

Feliz codificação!