Skip to content

Esse repositório foi feito como tutorial para o evento do Hacktoberfest 2021 na PUC Minas 🤙🏽

License

Notifications You must be signed in to change notification settings

izabelacborges/hacktoberfest-at-pucminas

Repository files navigation

Hacktoberfest 2021 @ PUC Minas

git the Fork on! talk by @izabelacborges

O intuito desse repositório é fornecer fontes para o aprendizado de git, e conscientização sobre contribuições open source, como forma de promover contribuições ao Hacktoberfest.

O que é o Hacktoberfest?

O Hacktoberfest é um evento mundial promovido pela Digital Ocean que ocorre anualmente no mês de Outubro com o intuito de incentivar pessoas a contribuir para projetos open source hosteados no Github e Gitlab.

Como meio de incentivo, a Digital Ocean premia todos os participantes que completarem o número necessário de pull requests, com uma camisa do evento e um pack de adesivos.

Para participar do Hacktoberfest é só você se inscrever por aqui.

Regras do Hacktoberfest

Para ganhar a camisa, você deve fazer 4 pull requests (PRs) entre 1º e 31 de Outubro em qualquer fuso horário. PRs podem ser feitos em qualquer repositório aberto no Github ou Gitlab, com o tópico 'hacktoberfest' associado. Os PRs devem conter commits que você mesmo fez, sem o uso de bots, e sem que sejam para um repositório aberto por você mesmo. PRs reportados por mantenedores como spam ou que tenham sido automatizados serão marcados como inválidos e não serão contados como válidos para ganhar a camisa. Em 2021, os primeiros 50,000 a completarem os 4 PRs ganharão a camisa.

Valores do Hacktoberfest

  • Todas as pessoas são bem-vindas
  • Quantidade é divertido, qualidade é fundamental
  • Ações de curto prazo para um impacto de longo prazo

Ações desencorajadas

  • PRs automatizados, como scripts para abrir Prs que deletem espaços em branco no fim de linhas ou que otimizem imagens.
  • PRs que são classificados como intrometidos, como usar uma branch ou commits de outro usuário para fazer um PR.
  • PRs que são marcados por um mantenedor de repositório/projeto como um um dificultador ao invés de uma ajuda.
  • Inserir seu nome em um arquivo de texto ou markdown apenas para criar um PR.
  • Algo que é claramente apenas uma maneira de aumentar a sua contagem de PRs em +1.

Por último, um PR consertando um erro de grafia em uma documentação é ok. 5 PRs já não são.

Instalando o Git

Nós temos um tutorial de como instalar o git aqui!

Aprendendo Git

Esse repositório é essencialmente algo para acompanhar o meet up de Git que o DACC junto com a Coordenação do curso de Ciência da Computação oferece aos alunos da PUC-MG anualmente no mês de outubro, então caso você não tenha participado do encontro, procure saber se algum ainda vai ocorrer em Outubro deste ano. Você pode verificar isso no instagram e facebook do DACC, ou entrar em contato com a coordenação do ICEI em [email protected].

Caso já tenham acontecido os meet ups, você pode ver nosso material de apoio do meet up com o tutorial de git neste link.

Você também pode acessar o Guia Prático de git que contém os comandos básicos para criar/clonar um repositório e fazer seus commits. Caso queira ter algo sempre à mão, você pode baixar e imprimir a cheatsheet de comandos compilada pelo GitHub.

Se quiser aprender a usar o git like a pro, usando um workflow que a maioria das grandes empresas usam, é só usar o git flow nos seus projetos.

Fazendo um Pull Request (PR)

A quarta seção do nosso material de apoio tem um tutorial de como fazer um fork e um pull request, e você pode facilmente seguir esse tutorial :D

Também existe esse post mais detalhado sobre como fazer um PR e você pode segui-lo.

Projetos legais para colaborar

Se você nunca colaborou com um projeto open source, você pode ler um pouco sobre porquê você deveria contribuir.

E aqui tem uma lista de lugares que compartilham links de projetos onde iniciantes podem ajudar:

Se você se sente um pouco mais confortável com contribuições, a @jtemporal compilou uma lista de repositórios brasileiros 🇧🇷 separados por linguagem, que precisam de contribuições!

Boas práticas ao fazer seus commits, issues e PRs

Temos um mini guia de boas práticas aqui :)

Dica pro fim de semana do pessoal

A publi aqui é gratuita, só porque eu curto mesmo...

About

Esse repositório foi feito como tutorial para o evento do Hacktoberfest 2021 na PUC Minas 🤙🏽

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published