|
| 1 | +# PHPay - Manual de Contribuição |
| 2 | + |
| 3 | +Seja bem-vindo(a) à nossa área de contribuição para o projeto PHPay! Estamos felizes por você estar interessado(a) em colaborar com nosso projeto open source. Suas contribuições são extremamente importantes para o crescimento e evolução do PHPay. |
| 4 | + |
| 5 | +## ❓ Como contribuir? |
| 6 | + |
| 7 | +1. Antes de começar |
| 8 | + Leia a documentação: Familiarize-se com o código e os objetivos do projeto. |
| 9 | + Respeite o Código de Conduta: Certifique-se de seguir as diretrizes de comportamento, promovendo um ambiente colaborativo e inclusivo. |
| 10 | + Verifique as Issues: Dê uma olhada nas issues abertas para encontrar algo que você possa resolver ou melhorar. |
| 11 | +2. Passo a passo para contribuir |
| 12 | + 🍴 Faça um fork do repositório |
| 13 | + |
| 14 | + No repositório do PHPay, clique no botão Fork no canto superior direito. |
| 15 | + 🎋 Clone o repositório para sua máquina local |
| 16 | + |
| 17 | + ```bash |
| 18 | + git clone https://github.com/seu-usuario/phppay.git |
| 19 | + cd phpay |
| 20 | + ``` |
| 21 | + |
| 22 | + 🎋 Crie uma branch para sua contribuição |
| 23 | + |
| 24 | + Use um nome descritivo para a branch que reflete a feature ou correção que você está implementando: |
| 25 | + |
| 26 | + ```bash |
| 27 | + git checkout -b feature/nome-da-feature |
| 28 | + ``` |
| 29 | + |
| 30 | + 🗒️ Implemente sua contribuição |
| 31 | + |
| 32 | + Mantenha o código limpo e organizado. |
| 33 | + Siga as convenções de código do projeto. |
| 34 | + Escreva testes para validar suas alterações sempre que possível. |
| 35 | + |
| 36 | + 🗒️ Faça commit das suas alterações |
| 37 | + |
| 38 | + Escreva mensagens de commit claras e descritivas: |
| 39 | + |
| 40 | + ```bash |
| 41 | + git commit -m "feat: [descrição da feature]" |
| 42 | + ``` |
| 43 | + |
| 44 | + ✏️ Envie suas alterações para o repositório do fork |
| 45 | + |
| 46 | + ```bash |
| 47 | + git push origin feature/nome-da-feature |
| 48 | + ``` |
| 49 | + |
| 50 | + ✈️ Abra um Pull Request |
| 51 | + |
| 52 | + No repositório original do PHPay, clique em Pull Requests e, em seguida, clique em New Pull Request. |
| 53 | + Escolha a branch que você criou no seu fork e compare-a com a branch principal do repositório original. |
| 54 | + Adicione uma descrição detalhada do que sua contribuição resolve ou melhora. |
| 55 | + |
| 56 | +## 3. Revisão e Feedback |
| 57 | + |
| 58 | +Sua contribuição será revisada por um dos mantenedores do projeto. |
| 59 | +Caso necessário, serão solicitadas alterações ou melhorias antes da aprovação. |
| 60 | +Após a aprovação, sua contribuição será integrada ao projeto principal. |
| 61 | + |
| 62 | + 🎉Diretrizes de Contribuição |
| 63 | + |
| 64 | + - Certifique-se de que seu código seja compatível com as versões do PHP suportadas pelo projeto. |
| 65 | + |
| 66 | + - Escreva testes unitários para novas funcionalidades ou correções de bugs. |
| 67 | + |
| 68 | + - Mantenha uma boa documentação do código, incluindo comentários e exemplos de uso. |
| 69 | + |
| 70 | + - Evite commits grandes e difíceis de revisar. |
| 71 | + |
| 72 | + - Divida suas alterações em partes menores e mais específicas. |
| 73 | + |
| 74 | +## 💻 Ambiente de Desenvolvimento |
| 75 | + |
| 76 | +Certifique-se de configurar corretamente o ambiente de desenvolvimento local: |
| 77 | + |
| 78 | +Requisitos básicos: |
| 79 | + |
| 80 | +- PHP ^8.1 |
| 81 | +- Composer. |
| 82 | + |
| 83 | +## 🏗️ Instalando as dependências: |
| 84 | + |
| 85 | +```bash |
| 86 | +composer install |
| 87 | +``` |
| 88 | + |
| 89 | +## 🖥️ Configuração do ambiente: |
| 90 | + |
| 91 | +Renomeie o arquivo credentials.example.php para credentials.php e configure suas chaves de do seu gateways. |
| 92 | + |
| 93 | +## Rodando os testes: |
| 94 | + |
| 95 | +```bash |
| 96 | +composer tests |
| 97 | +``` |
| 98 | + |
| 99 | +## ✉️ Entre em contato |
| 100 | + |
| 101 | +Caso tenha dúvidas ou precise de ajuda, sinta-se à vontade para abrir uma issue ou entrar em contato com a equipe de mantenedores. |
| 102 | + |
| 103 | +Agradecemos desde já por suas contribuições. 💙 |
| 104 | +Juntos podemos tornar o PHPay ainda melhor! |
0 commit comments