O Hacktoberfest é uma celebração anual de um mês de projetos, mantenedores e colaboradores de código aberto. O evento visa promover o código aberto e incentivar os desenvolvedores a contribuir.
O Hacktoberfest vem com incentivos para os primeiros 40.000 participantes que obtiverem quatro solicitações pull mescladas até 31 de outubro. Você pode obter uma árvore plantada em seu nome ou uma camiseta do Hacktoberfest.
Tudo começa com sua primeira solicitação pull/merge.
Inscrições para Hacktoberfest
Para participar do Hacktoberfest, você deve primeiro se registrar no evento em hacktoberfest. com.
Você verá uma tela semelhante a esta:
Você deve ter uma conta GitHub ou GitLab para participar.
Escolha seu serviço de hospedagem preferido e clique no botão INICIAR botão. Ao clicar neste botão, você será redirecionado para o aplicativo escolhido, que solicitará a aprovação do Hacktoberfest.
Autorizar o Hacktoberfest automaticamente o registrará no evento.
Encontrar projetos para contribuir no GitHub e GitLab
Apenas contribuições para projetos de código aberto participantes em GitHub ou GitLab contará para o Hacktoberfest. Você deve ter uma conta GitHub ou GitLab para participar.
GitHub
Para encontrar projetos participantes do Hacktoberfest no GitHub:
- Navegar para github.com.
- Navegue até a barra de pesquisa no GitHub ou pressione a tecla de barra (/) em seu teclado.
- Digite “Hacktoberfest” e clique no botão DIGITAR botão.
Seguir as etapas acima exibirá vários resultados, com o tópico Hacktoberfest bem no topo. Este tópico fornecerá uma lista de repositórios para os quais você pode contribuir, conforme mostrado na imagem abaixo.
Alternativamente, você pode ir diretamente para o GitHub Hacktoberfest tema.
GitLabGenericName
Para encontrar projetos participantes do Hacktoberfest no GitLab:
- Navegar para gitlab.com.
- Na página inicial, selecione explorar projetos públicos.
- Na página de exploração de projetos, selecione explorar tópicos.
- No filtrar por pesquisa campo, digite "Hacktoberfest".
Seguir as etapas acima exibirá vários resultados, com o tópico Hacktoberfest sendo o primeiro. Este tópico fornecerá uma lista de repositórios para os quais você pode contribuir, conforme mostrado na imagem abaixo.
Alternativamente, você pode ir diretamente para o GitLab Hacktoberfest tema.
Criando uma solicitação pull (PR) no GitHub
Um pull request (PR) é uma proposta feita por um colaborador de um projeto pedindo ao mantenedor do projeto para revisar e mesclar as alterações propostas ao projeto.
Para fazer um PR, você deve encontrar um projeto Hacktoberfest para o qual deseja contribuir. Depois de encontrar um projeto, clique no botão garfo botão no canto superior direito:
Bifurcar um projeto cria uma cópia do projeto em sua conta do GitHub, permitindo que você faça alterações sem afetar o projeto principal. Depois de bifurcar o projeto, clone o repositório de sua conta e faça as alterações em seu ambiente de desenvolvimento local.
Certifique-se de ler as diretrizes de contribuição do projeto e segui-las para aumentar as chances de sua solicitação pull.
Depois de fazer as alterações e adicionar sua versão bifurcada do repositório, confirme as alterações usando o Gite envie-os para o GitHub.
Quando as alterações forem refletidas no GitHub, você receberá um aviso informando que sua bifurcação está “confirmada” à frente da ramificação principal, conforme mostrado na imagem abaixo.
A seguir, clique no contribuir botão no prompt. Clicar neste botão solicitará que você abra uma solicitação pull, conforme mostrado na imagem abaixo.
Em seguida, clique no solicitação de pull aberta botão. Isso o levará a uma página onde você revisará as diretrizes de contribuição e um título e uma descrição para sua solicitação pull.
Preencha os campos obrigatórios e clique no botão Criar solicitação de recebimento botão, como mostrado na imagem abaixo.
Você criou uma solicitação pull. Agora, espere que os mantenedores do projeto revisem e mesclem ou rejeitem sua contribuição.
Criando uma solicitação de mesclagem no GitLab
Uma solicitação de mesclagem é idêntica a uma solicitação pull. A única diferença são seus respectivos nomes.
Para fazer uma solicitação de mesclagem, você deve primeiro encontrar um projeto Hacktoberfest para o qual deseja contribuir. Depois de encontrar um projeto, clique no botão de bifurcação no canto superior direito:
Bifurcar um projeto cria uma cópia do projeto em sua conta do GitLab, permitindo que você faça alterações sem afetar o projeto principal. Depois de bifurcar o projeto, clone o repositório de sua conta e faça as alterações em seu ambiente de desenvolvimento local.
Certifique-se de ler as diretrizes de contribuição do projeto e segui-las para aumentar as chances de sua solicitação pull.
Depois de fazer as alterações e adicionar sua versão bifurcada do repositório, confirme as alterações e empurre-os para o GitLab.
Depois de enviar suas alterações para o GitLab, navegue até o projeto bifurcado e clique em Solicitações de mesclagem na barra lateral. Isso abrirá uma tela explicando uma solicitação de mesclagem e um Nova solicitação de mesclagem botão. Clique no Nova solicitação de mesclagem botão, como mostrado na imagem abaixo.
Em seguida, você precisará selecionar um fonte e alvo filial. O fonte branch deve ser o branch onde residem as alterações que você deseja enviar para o repositório principal. O alvo branch deve ser o repositório principal onde você deseja confirmar suas alterações. Após selecionar as filiais, clique no botão Comparar filiais e continuar botão, como mostrado na imagem abaixo.
Clicando no Comparar filiais e continuar O botão o levará a uma página onde você pode inserir um título e uma descrição para sua solicitação de mesclagem.
Preencha os dados solicitados e clique no botão Criar botão de solicitação de mesclagem, como mostrado na imagem abaixo.
Clicar neste botão cria sua solicitação de mesclagem. Agora você tem que esperar que os mantenedores do projeto revisem e mesclem ou fechem sua solicitação pull.
Termos e Condições do Hacktoberfest
Todas as contribuições feitas para projetos do Hacktoberfest devem estar dentro dos limites do Hacktoberfest e não ser spam. O não cumprimento das regras do Hacktoberfest pode acarretar na desclassificação do evento.
O Hacktoberfest emite um período de revisão de sete dias para solicitações pull/merge que seguem todas as diretrizes. Se o seu PR for bom, o projeto deve aceitá-lo para o Hacktoberfest dentro desse prazo.
Boa contribuição!