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.
Na lista abaixo estarão todos os exercicios que iremos aceitar nos nossos pull request.
- 0 - Hello World (não irá contar)
- 1 - Média de alunos
- 2 - Tabuada
- 3 - Área de um trapézio
- 4 - Cifra de César
- 5 - Frequência das Letras
- 6 - Abracadabra
- 7 - Validador de Senhas
- 8 - Fibonacci Fácil
Caso você queira dar sugestões de desafios, contate algum moderador no Discord da He4rt.
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
- Vá até o repositório do fork no seu github e na parte code copie o link para clonar
- Abra o terminal, escolha uma pasta de sua preferência e faça um clone git clone cole o link que você copiou
- Crie uma pasta da linguagem que você escolheu no diretório
challenges/id_challenge/lang/ - Depois dentro desta pasta lang crie a pasta com seu nickname ficando assim
challenges/id_challenge/lang/nickname - Resolva o desafio
- Copie o model.md para a sua pasta, preencha com as informações descritas e renomeie o arquivo para README.MD
- Crie um branch com o desafio seguindo o modelo ao lado
(git checkout -b challenges/id_challenge/lang/nickname) - O exemplo acima ficaria assim do desafio 0 feito em PHP:
(git checkout -b challenges/0/php/danielhe4rt) - Depois faça
git add . - Realize o Commit
(git commit -m 'Finalizando o desafio') - Realize o Push no Branch
(git push origin challenges/id_challenge/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.
Caso esse repositório seja atualizado com novos exercícios você precisa atualizar seu fork
# 1. Mudar para a branch master
git checkout master
# 2. Checar se sua cópia local tem o link do original
git remote -v
# 3. Se não, adicione o link do original
git remote add upstream git@github.com:he4rtlabs/he4rtoberfest-2020.git
# 4. Confirme se o link foi adicionado
git remote -v
# 5. Agora você pode fazer o fetch com o repo original, assumindo que o nome do link é 'upstream'
git fetch upstream
# 6. Fazer merge dos updates para sua branch master
git merge upstream/master master
# 7. Realizar o push para seu fork com as novas mudanças
git push origin master