Quer seja o seu primeiro ou quinquagésimo Pull Request, sempre há mais para aprender! Reunimos alguns recursos que podem lhe ajudar a criar Pull Requests de qualidade, manter os seus repositórios impecáveis e desenvolver o seu conhecimento em open source.
Inspirados em vocês - a comunidade -, pelas suas ações e histórias.
- Todas as pessoas são bem-vindas! As participantes na Hacktoberfest representam 151 países e milhares de conjuntos de habilidades exclusivas. Este programa dá boas-vindas a todas que já fazem parte da comunidade de software open source, e a todas que estão interessadas em se unir.
- Quantidade é divertido, qualidade é a chave Participar da Hacktoberfest leva a crescimento pessoal, oportunidades profissionais e construção de comunidade. Contudo, tudo começa com contribuições significativas para o software open source
- Ação de curto prazo, impacto de longo prazo Na comunidade de software open source, nos apoiamos nos ombros daqueles que vieram antes de nós. A sua participação terá um efeito duradouro nas pessoas e na tecnologia após outubro. Esta é uma viagem, não uma corrida.
Recomendamos a todas as participantes que leiam todos os detalhes para garantir que a comunidade global trabalhe em direção a um objetivo em comum. Agradecemos por honrar os valores e seguir as regras de participação.
- A Hacktoberfest está aberta a todas as pessoas na nossa comunidade global. Quer seja uma contribuidora experiente ou esteja a procura de projetos para contribuir pela primeira vez, sinta-se à vontade para participar.
- As solicitações de pull request podem ser feitas em qualquer repositório ou projeto hospedado no GitHub. Contanto que o projeto esteja público e hospedado no GitHub, as suas solicitações de pull request contarão para a sua participação (observação: há novos requisitos, veja a seção sobre a atualização das regras)
- Você pode se inscrever a qualquer momento entre 1º e 31 de outubro. Apenas se certifique de fazer a sua inscrição no site oficial da Hacktoberfest para que as suas solicitações de pull request sejam contabilizadas.
Para ganhar uma camiseta oficial do evento, você deve fazer no mínimo quatro pull requests (PRs) entre o
dia 1º e o dia 31 de outubro em qualquer fuso horário. As solicitações de PR podem ser feitas para qualquer
repositório público no GitHub, não apenas os repositórios destacados.
(ver regras atualizadas)
A solicitação pull request deve conter commits de sua autoria. Se uma pessoa mantenedora relatar a sua solicitação de pull request como spam, ele não será contabilizado para a sua participação na Hacktoberfest. Se uma pessoa mantenedora relatar um comportamento que não esteja de acordo com o código de conduta do projeto, você não poderá participar.
Este ano, as primeiras 70.000 participantes podem ganhar uma camiseta.
De acordo com o valor #2 (Quantidade é divertido, qualidade é a chave), providenciamos exemplos de pull requests que consideramos contribuições de baixa qualidade (o que desencorajamos).
- Pull requests que são automatizados (exemplo: abrir pull requests com script para remover espaços em branco/corrigir erros de digitação/otimizar imagens).
- Pull requests que são disruptivos (exemplo: pegar a branch/o commit de outra pessoa e solicitar pull request).
- Pull requests que são considerados pela pessoa mantenedora um obstáculo em vez de ajuda.
- Algo que seja uma tentativa explícita de simplesmente adicionar +1 pull request à sua contagem de outubro.
Por último, mas não menos importante, um pull request para arrumar erro de digitação é ok, mas 4 pull requests para remover um espaço em branco perdido, não.
- Pull Requests considerados spam podem ser rotulados como “inválido” ou "spam" para que não sejam contabilizados.
As pessoas mantenedoras lidam com a maior parte do spam que ocorre durante a Hacktoberfest, e não gostamos de spam
tanto quanto você. Se você for uma pessoa mantenedora, por favor, rotule todas as solicitações de pull requests spam
enviadas aos repositórios que você mantém como
invalidouspame as feche. Pull Requests com estas etiquetas não contam para a Hacktoberfest. - Há uma janela de quatorze dias para revisão de todos os pull requests antes de os mesmos serem contabilizados para a conclusão do desafio. Depois que uma participante envia quatro pull requests elegíveis (prontas para revisão, não rascunhos), a janela é iniciada. Este período dá às pessoas mantenedoras tempo para identificar e rotular os pull requests que são spam como inválidos. Se os pull requests não forem marcados como inválidos nessa janela, será possível que a usuária conclua o desafio do Hacktoberfest. Se qualquer um dos pull requests for rotulado como inválido, a usuária retornará ao estado pendente até que tenha quatro pull requests qualificados, e então período de revisão começará novamente.
- Repositórios ruins serão excluídos. No passado, vimos muitos repositórios que incentivavam as participantes a fazerem pull requests simples (como adicionar os seus nomes a um arquivo) para obter rapidamente um pull request para concluir a Hacktoberfest. Embora possa ser uma ferramenta de aprendizado para novos colaboradores, vai contra um dos nossos valores fundamentais da Hacktoberfest. A qualidade dos pull requests é fundamental; a quantidade vem em segundo lugar. Esses repositórios não incentivam contribuições de qualidade e fornecem uma vantagem injusta na conclusão do desafio da Hacktoberfest. Implementamos um sistema para bloquear esses repositórios e quaisquer pull requests enviados a eles não serão contabilizados.
Clique aqui para denunciar um repositório que não segue os valores do Hacktoberfest.
- Recursos para iniciantes
- Recursos para mantenedoras
- Recursos para organizadoras de evento
- Recursos para empresas
Após vários relatos de spam ocorrendo nos primeiros dias do evento, a organização da Hacktoberfest em conjunto com o Github reformulou as regras para evitar vários pull requests inválidos.
Tornamos a Hacktoberfest opt-in only para os projetos, ou seja, apenas repositórios que ativamente sinalizarem
farão parte da contagem dos pull requests do desafio.
As pessoas mantenedoras poderão fazer essa sinalização adicionando o tópico hacktoberfest ao repositório.
Esta foi uma das principais solicitações das pessoas mantenedoras e esperamos que isto ajude a aliviar um pouco dos problemas que têm acontecido.
Honraremos todos os pull requests válidos antes desta mudança, e, após o dia 3 de outubro de 2020 às 12:00
UTC - e 3 de outubro em todos os fuso-horários - pull requests só contarão para ganhar a camiseta ou plantar uma
árvore se forem rotulados como hacktoberfest-accepted por uma pessoa mantenedora ou submetidos a um repositório
classificado com o tópico hacktoberfest. Nesse último caso, os pull requests também precisarão ter sido mergeados,
ter sido aprovados por uma pessoa mantenedora ou ter recebido a etiqueta hacktoberfest-accepted para serem
qualificados. O prazo para concluir, mergear, receber a etiqueta hacktoberfest-accepted e aprovar é 1º de novembro.
Para ilustrar as regras de uma forma que combina com o espírito da Hacktoberfest:
O Pull Request conta se:
Submetido durante o mês de Outubro E
Submetido a um repositório público E (
O PR foi rotulado como "hacktoberfest-accepted" por uma pessoa mantenedora OU
Submetido a um repositório que tem o tópico "hacktoberfest" E (
O PR foi mergeado OU
O PR foi aprovado
)
)
Nota às pessoas mantenedoras: com estas mudanças, você não precisa mais se descadastrar da Hacktoberfest. Em vez
disso, convidamos você a classificar o seu repositório com o tópico hacktoberfest e aplicar a etiqueta
hacktoberfest-accepted aos pull requests que são válidos, mesmo aqueles que não serão mergeados. Incluímos alguns
gifs abaixo para mostrar como é simples.
Fonte: Hacktoberfest 2020.
Passo descrito no gif:
- Ir nas configurações do seu repositório e adicionar
hacktoberfestno campo Tópico e confirmar a alteração.
Fonte: Hacktoberfest 2020.
Passos descritos no gif:
- Entrar na aba "Pull Requests" ou na aba "Issues"
- Clicar em "Labels"
- Clicar no botão "New label"
- Preencher o campo "Label name" com
hacktoberfest-accepted, preencher o campo "Description" com a descrição (é opcional) e escolher a cor da etiqueta - Clicar no botão "Create label"
- Entrar na aba de Pull Requests
- Entrar no PR avaliado e adicionar a nova etiqueta criada no passo 5 no lado direito da tela, na seção Labels.