Adicionando um novo projeto na lista da #Hacktoberfest
Nota da autora: As instruções a seguir foram criadas em 2019, mas a forma de atualizar a lista de projetos se manteve desde então. Então mesmo que você queira atualizar a lista desse ano os passos são os mesmo 😉 —
A lista de projetos brasileiros para contribuir nesse Hacktoberfest de 2019 é gerada automáticamente usando algumas mágicas do Liquid . Então, vamos ver como podemos adicionar um novo projeto nessa lista por meio de um pull request?
É hora do show!
Materiais
- Um navegador (eu vou usar o Firefox, mas você pode usar o que preferir);
- Uma conta no GitHub;
- Disposição.
Nota da autora: existem inúmeras formas de fazer esse pull request (PR), aqui eu vou ensinar um formato usando o navegador para que você possa fazer sua contribuição mesmo que você não tenha conhecimentos profundos de git. Se você já tem prática em contribuir com projetos no GitHub, pula direto para essa seção que tem uma lista de passos menos detalhada do PR que deve ser o suficiente pra você fazer a sua contribuição.
Abrindo o repositório do PR
Pra começar abra o repositório desse site aqui numa página do seu navegador.
Imagem mostrando o repositório deste site
Copiando o template
No repositório desse site, que você acabou de abrir, navegue até a pasta .github/ e copie o conteúdo do arquivo repo-owner+repo-name.md (eu recomendo que você use o modo Raw do arquivo para fazer essa cópia). Veja o gif a seguir com esse processo:
Esse arquivo é o template de informações necessárias para mostrar corretamente um projeto na lista.
Onde moram os projetos
Ainda no repositório desse site, vá até a pasta _hacktoberfest_projects/, lá é onde moram os dados de todos os projetos que estão sendo mostrados na lista de 2019:
Na pasta _hacktoberfest_projects/ temos muitas pastas, elas existem apenas como por questões organizacionais, cada pasta tem o nome de uma linguagem, e o projeto que você quer adicionar deve ser acrescentado na pasta correspondente à linguagem principal do projeto.
Escolhendo um projeto para adicionar
Agora, numa nova página, abra o repósitorio que você quer adicionar na lista. Aqui vamos usar de exemplo o Guia do Cientista de Dados das Galáxias (Guia).
Imagem mostrando o repositório Guia do Cientista de Dados das Galáxias
Criando um arquivo para o projeto
O Guia é um projeto agnóstico de linguagem, afinal é apenas um grande conjunto de arquivos em markdown, sendo assim, vamos criar o arquivo do Guia na pasta Variados. Novamente na página do site, navegue até pasta _hacktoberfest_projects/ e em seguida entre na pasta Variados. Para criar o arquivo clique em Create new file, em seguida cole o conteúdo que copiamos do arquivo repo-owner+repo-name.md no espaço de conteúdo, dê o nome do arquivo seguindo o padrão <nome-do-dono-do-repo>+<nome-nome-do-repo>.md. Veja:
Preenchendo as informações
Agora você pode preencher os dados do projeto no nosso arquivo, só precisamos de quatro informções:
- O link do repositório (campo
repo); - O link pra imagem de perfil da pessoa dona do repositório (campo
image); - A descrição do repositório (campo
description); - E a linguagem principal do repositório (campo
principal_language).
Para tudo isso basta copiar essas informações na página do repositório e colar na linha de campo correspondente no nosso arquivo.
Abrindo o PR
Depois de preencher todos os campos necessários presentes no nosso arquivo, basta abrir o PR. Então apenas desça até a área de detalhes do commit, escreva uma mensagem descrevendo qual projeto você está adicionando, clique em Propose new file e siga para propor o PR clicando em Create Pull Request.
Possíveis problemas
Existem principalmente dois casos em que esse fluxo que eu descrevi até agora vai precisar de ajustes, mas não precisa se desesperar, eu explico eles abaixo.
Caso 1: quero adicionar uma linguagem nova
Caso o projeto que você queira adicionar na lista tenha uma linguagem principal diferente daquelas já disponíveis, você deverá criar uma nova pasta. Para fazer isso pela interface do GitHub no navegador, basta você escrever o nome da pasta no campo onde escrevemos o nome do arquivo seguido de uma barra (/), ao digitar a barra, o GitHub se encarregará de criar a pasta, veja:
No gif, eu crio a pasta chamada pasta2 e dentro dela crio o arquivo chamado meu-arquivo.md.
Caso 2: o projeto que eu quero adicionar não tem descrição
Nesse caso é mais fácil de resolver, basta colocar no campo description o conteudo No description assim como coloquei nesse projeto aqui:
Revisão dos passos
Então pra aquela galera que só precisa de uma explicação mais concisa aqui vai! São só três passos!
- Crie um arquivo na pasta correspondente à linguagem principal do projeto que você quer adicionar, use o template disponível aqui e não se esqueça de nomear o arquivo seguindo a convenção
<nome-do-dono-do-repo>+<nome-nome-do-repo>.md; - Preencha os campos com as informações do projeto que você quer adicionar;
- Abra o PR.
Aguarde a revisão e aprovação!
Se você quiser fazer um PR e não tem projeto em mente, dá uma olhada nessa lista aqui.
