Skip to content

Commit 20d1ee1

Browse files
PHPAY-40: doc: fix readme with link to contributing manual (#25)
2 parents 2a26963 + da55661 commit 20d1ee1

File tree

2 files changed

+114
-12
lines changed

2 files changed

+114
-12
lines changed

.github/CONTRIBUTING.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
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!

.github/README.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -50,14 +50,16 @@ $phpay
5050
- Domínios ✅
5151
- Documentação 🕑
5252
- Site 🕛
53-
- Asaas.
53+
- Gateways ✍️
54+
55+
- Asaas.
5456

5557
- Cobranças ✅
5658
- Clientes ✅
5759
- Webhook ✅
5860
- Pix 🕥
5961

60-
- Efí.
62+
- Efí.
6163

6264
- Autorização ✅
6365
- Cobranças ✅
@@ -69,21 +71,17 @@ $phpay
6971

7072
## 🌟 Contribuindo
7173

72-
Contribuições são muito bem-vindas!
73-
Para começar:
74-
75-
- 🍴 Faça um fork do projeto.
76-
- 🎋 Crie uma branch para sua feature (git checkout -b feature/nova-feature).
77-
- 🗒️ Faça commit das alterações (git commit -m 'Adicionei nova feature').
78-
- ✏️ Envie sua branch (git push origin feature/nova-feature).
79-
- ✈️ Abra um pull request para análise.
74+
Para contribuir com o PHPay, implementando melhorias e novos gateways de pagamento,
75+
leia nosso manual de contribuição. [MANUAL DE CONTRIBUIÇÃO PHPAY](./CONTRIBUTING.md)
8076

8177
## 📄 Licença
8278

8379
Este projeto está licenciado sob a MIT License. Consulte o arquivo [LICENSE](./LICENSE) para mais detalhes.
8480

85-
🤝 Contato
81+
## 🤝 Contato
82+
8683
💻 GitHub: [Mário Lucas](https://github.com/mariolucasdev)
87-
📧 Email: [email protected]
84+
85+
📧 Email: [email protected]
8886

8987
🎉 Comece a usar o PHPay e simplifique suas integrações com gateways de pagamento!

0 commit comments

Comments
 (0)