As contribuições são ** bem-vindas ** e serão totalmente creditadas **.
Por favor, leia e entenda o guia de contribuição antes de criar uma issue ou pull request.
Este projeto é de código aberto e, como tal, os mantenedores dão seu tempo livre para construir e manter o código fonte realizada dentro. Eles disponibilizam o código gratuitamente na esperança de que ele seja útil para outros desenvolvedores. Seria extremamente injusto para eles sofrer abuso ou raiva por seu trabalho duro.
Por favor, seja atencioso com os mantenedores ao criar issues ou pull requests. Vamos mostrar o mundo que os desenvolvedores são pessoas civilizadas e altruístas.
É dever do mantenedor assegurar que todas as submissões ao projeto sejam suficientes qualidade para beneficiar o projeto. Muitos desenvolvedores têm diferentes qualificações, pontos fortes e pontos fracos. Respeite a decisão do mantenedor e não fique chateado ou abusivo se o seu envio não for usado.
Ao solicitar ou enviar novos recursos, considere primeiro se ele pode ser útil para outras pessoas. Abrir Os projetos de código-fonte são usados por muitos desenvolvedores, que podem ter necessidades totalmente diferentes para você. Pense sobre se seu recurso provavelmente será usado por outros usuários do projeto.
Antes de criar uma issue:
- Tente replicar o problema, para garantir que não seja um incidente coincidente.
- Verifique se sua sugestão de feature ainda não está presente no projeto.
- Verifique a guia de pull requests para garantir que o bug não tenha uma correção em andamento.
- Verifique a guia de pull requests para garantir que o recurso ainda não esteja em andamento.
Antes de enviar uma pull request:
- Verifique a base de código para garantir que sua feature ainda não exista.
- Verifique as pull requests para garantir que outra pessoa ainda não tenha enviado a feature ou correção.
Se o mantenedor do projeto tiver quaisquer requisitos adicionais, você os encontrará listados aqui.
-
** [Padrão de Codificação PSR-2] (https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md) ** - O mais fácil A maneira de aplicar as convenções é instalar o [PHP Code Sniffer] (https://pear.php.net/package/PHP_CodeSniffer).
-
** Adicionar testes! ** - Sua pull request não será aceita se não tiver testes.
-
** Documente qualquer alteração no comportamento ** - Certifique-se de que o
README.md
e qualquer outra documentação relevante sejam mantidos atualizados. -
** Considere o nosso ciclo de lançamento ** - Nós tentamos seguir [SemVer v2.0.0] (https://semver.org/). Quebrar aleatoriamente APIs públicas não é uma opção.
-
** Uma feature por pull request ** - Se você quiser fazer mais de uma coisa, envie várias pull requests.
-
** Enviar histórico coerente ** - Certifique-se de que cada commit em sua pull request seja significativo. Se você teve que fazer vários commits intermediários durante o desenvolvimento, por favor faça [squash] (https://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages ) antes de enviar.