Como contribuir
Report Bug
·
Request Feature
Sejam todos bem vindos a primeira edição do He4rtoberfest, evento da He4rt Developers para incentivar novos desenvolvedores a participar do Hacktoberfest pela DigitalOcean e aprender um pouco mais sobre a ideia do open source.
A ideia da He4rt Developers sempre foi a inclusão dos mais iniciantes na área e iremos focar em trazer essa inclusão para o Hacktoberfest! Se liga:
A ideia se baseia em pegar exercicios de faculdade, desde o mais simples até o mais complexo e fazer nas mais variadas linguagens e assim deixando uma biblioteca gigante de conhecimento para novos universitários mostrando a maior quantidade de jeitos possíveis de resolver o mesmo problema.
Contribuições fazem com que a comunidade open source seja um lugar incrível para aprender, inspirar e criar. Todas contribuições são extremamente apreciadas
Porém, como esse será um evento, haverão algumas regras a serem seguidas para que você seja aprovado e não é nada complexo. Entenda:
- Para que você tenha um Pull Request (PR) aprovado vinculado ao Hacktoberfest, você terá que fazer um PR do desafio 0 (Hello World);
- Caso você faça os outros desafios e não faça o Hello World, seu PR não será aprovado enquanto não fizer o desafio inicial.
A ideia do desafio 0 é deixar registrado todos os participantes do He4rtoberfest, e por isso será obrigatório.
Quando você for criar a branch para mandar o Pull Request, você deverá seguir o exemplo abaixo:
- Realize um Fork do projeto
- Crie uma pasta no diretório `challenges/challenge_id/lang/nickname
- Resolva o desafio
- Copie o model.md para a sua pasta e preencha com as informações descritas
- Crie um branch com o desafio seguindo o modelo ao lado (
git checkout -b challenges/challenge_id/lang/nickname) - O exemplo acima ficaria assim do desafio 0 feito em PHP: (
git checkout -b challenges/0/php/danielhe4rt) - Realize o Commit (
git commit -m 'Finalizando o desafio') - Realize o Push no Branch (
git push origin challenges/challenge_id/lang/nickname) - Abra um Pull Request
Como o nosso objetivo será dar a melhor experiência possível para o participante, nós iremos ter algumas regras básicas de revisão de código para que seja uma experiência interessante para quem está aplicando o desafio, sendo elas:
- Reforçar uma leitura de código e tipagem quando possível;
- Erros de digitação/gramaticais e nomes de variáveis sem um contexto, tais como [a,b,c,x,y,z] deverão ser pedidas alterações;
- Isolamento de funções quando necessário também poderá ser requisitado.
Qualquer dúvida, poderá ir o nosso banco de dúvidas e perguntar.
