Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Hacktoberfest é um evento anual em todo o mundo mantido durante o mês de outubro. O evento incentiva os desenvolvedores de código aberto a contribuir com os repositórios por meio de PR (pull requests). O GitHub hospeda muitos repositórios de software livre que contribuem para o conteúdo do Microsoft Learn. Alguns dos repositórios participam ativamente do evento Hacktoberfest. Neste artigo, você aprenderá a descobrir quais repositórios estão aceitando os PRs e o que você pode esperar como contribuidor.
Localizar um repositório
Para descobrir se um repositório do Microsoft Learn está participando do Hacktoberfest, veja o tópico Hacktoberfest sobre o projeto.
Para filtrar todos os repositórios do Microsoft Learn e .NET que apresentam o tópico Hacktoberfest, confira Tópicos do GitHub: Hacktoberfest.
Como alternativa, um repositório pode optar por usar o rótulo Hacktoberfest. Esse rótulo é conveniente para filtrar issues. Para obter mais informações, confira Problemas de filtragem e pull requests por rótulos.
Dica
Se você for um administrador de repositório e quiser permitir que seu repositório participe do Hacktoberfest, adicione o tópico hacktoberfest ao repositório. Para obter mais informações, confira Como classificar seu repositório com tópicos.
Contribuir
Para contribuir com um repositório de software livre, você deve primeiro configurar sua conta para contribuir com o Microsoft Learn. Se você nunca concluiu esse processo, comece criando uma conta no GitHub. Você também deve registrar um perfil para acompanhar seus esforços. Confira Hacktoberfest.
Assim que a conta estiver configurada, comece lendo e aderindo ao arquivo CONTRIBUTING.md na raiz do repositório com o qual deseja contribuir. Esses arquivos servem como um guia para a contribuição. Aqui estão alguns exemplos de guias do contribuidor de alguns repositórios populares do Microsoft Learn:
Além do arquivo Markdown de contribuição, se um repositório tiver um arquivo CODE_OF_CONDUCT.md, isso será um requisito para aderir ao comportamento esperado na comunidade. Novamente, aqui estão alguns exemplos comuns:
Para obter mais informações, confira Hacktoberfest: participação.
Escolha um issue
Para localizar um issue de trabalho em um repositório participante, filtre os issues para os rótulos up-for-grabs ou help-wanted do GitHub. Embora você possa resolver outros issues, é mais fácil se concentrar em issues que têm um escopo bem definido e são independentes. Além dos repositórios do Microsoft Learn, você pode usar os seguintes sites para iniciantes:
Para obter mais informações, confira Hacktoberfest: iniciantes.
Expectativas de qualidade
Para ter uma contribuição bem-sucedida para um repositório de código aberto do Microsoft Learn, crie uma PR significativa e impactante. Os exemplos a seguir do site oficial do Hacktoberfest são considerados contribuições de baixa qualidade:
- PRs que são automatizadas (por exemplo, PRs de abertura com script para remover espaços em branco, corrigir erros de digitação ou otimizar imagens).
- PRs que causam interrupções (por exemplo, pegar o branch ou os commits de outra pessoa e fazer uma PR).
- PRs que são considerados por um mantenedor do projeto como um obstáculo em vez de ajuda.
- Um envio que é claramente uma tentativa de simplesmente aumentar sua contagem em +1 PR para outubro.
Por fim, uma PR para corrigir um erro de digitação é bom, mas cinco PRs para remover um espaço em branco perdido, não.
Para obter mais informações, confira Hacktoberfest: valores.
Abrir uma PR
Uma PR fornece uma forma conveniente para um contribuidor propor um conjunto de alterações. Ao abrir uma PR, especifique no comentário original que ela pretende contribuir para o hacktoberfest. PRs bem-sucedidas têm estas características comuns:
- A PR adiciona valor.
- O contribuidor pode receber feedback.
- As alterações pretendidas são bem articuladas.
- As alterações estão relacionadas a um issue existente.
Se você estiver propondo uma PR sem um issue correspondente, crie um issue primeiro. Para obter mais informações, confira GitHub: sobre pull requests.