- Dê uma Estrela no Repositório ⭐
- Encontre uma Issue para Trabalhar 🔍
- Volte para o Branch Main 🎋
- Atualize o Branch Main 🎋
- Crie um Novo Branch 🎋
- Faça suas Alterações 🔨
- Adicione suas Alterações ➕
- Faça um Commit de suas Alterações ✅
- Faça um Push de suas Alterações 🤞
- Crie um Pull Request (PR) no GitHub 💬
Antes de começar a trabalhar na sua segunda tarefa, é necessário dar uma estrela no repositório do GitHub. Dar uma estrela não apenas demonstra seu apoio ao projeto, mas também cria uma notificação para você sempre que houver atualizações ou atividades. Veja como fazer isso:
- Acesse o Repositório: Navegue até a página principal do projeto no GitHub: https://github.com/cumbucadev/gitcaos
- Clique no Botão de Estrela: Procure o botão Estrela localizado no canto superior direito da página, logo abaixo do nome do repositório. Clique nele!
Agora é hora de encontrar uma issue (tarefa ou problema) para trabalhar. Esse é um passo importante e comum no mundo do open source, onde colaboramos para melhorar projetos e aprender juntos. No GitCaos 🔥, usamos as issues para organizar as atividades do projeto. Isso pode incluir corrigir bugs, adicionar novas funcionalidades e melhorar a documentação.
Siga estas etapas simples para encontrar sua primeira issue:
- Acesse o Repositório: Navegue até a página principal do projeto no GitHub: https://github.com/cumbucadev/gitcaos
- Na parte superior da página do repositório principal, você verá várias abas. Clique na aba chamada Issues. Aqui, você encontrará uma lista de tarefas disponíveis que precisam de ajuda.
- Procure pela issue específica: Agora, você precisa encontrar uma issue com o título: # Tarefa 2: O Jogo do Tigrinho me deu (seu-username). Essa tarefa foi criada especialmente para você, e é uma ótima oportunidade para praticar.
- Verifique se a issue já está designada para alguém: Olhe ao lado do título da issue para ver se ela já tem alguém designado (chamado de assignee). Se o seu nome já estiver lá, ótimo! Isso significa que você está pronto para trabalhar na tarefa. Se não estiver, você pode pedir para ser designado. Para isso, deixe um comentário na issue dizendo algo como: "Oi, eu gostaria de trabalhar nessa tarefa! Você pode me designar?". Isso garante que nunca mais de uma pessoa trabalhe na mesma issue, evitando conflitos e confusões no desenvolvimento.
- Leia atentamente as instruções: Antes de começar a trabalhar, é fundamental ler todas as instruções que estão na issue. Isso vai garantir que você entenda o que é solicitado e que siga as diretrizes corretamente. Preste atenção a detalhes como formato de arquivo, informações que devem ser incluídas e qualquer outro requisito.
Importante: Quando você deu uma estrela no repositório, isso criou automaticamente uma issue para você. Essa é uma forma didática de ajudar novos colaboradores a encontrar uma tarefa prática e se familiarizar com o processo. Normalmente, você encontrará outras tarefas disponíveis que também precisarão de ajuda.
- Abra o terminal no seu computador.
- Navegue até a pasta do seu projeto GitCaos. Use o comando
cd caminho/do/seu/projetopara acessar a pasta correta. - Execute o comando abaixo
git checkout main- Abra o terminal no seu computador.
- Navegue até a pasta do seu projeto GitCaos. Use o comando
cd caminho/do/seu/projetopara acessar a pasta correta. - Execute o comando abaixo
git pullAntes de começar a trabalhar nas suas alterações, você precisa criar um novo branch. Um branch é uma linha de desenvolvimento independente, onde você pode fazer mudanças sem afetar o código que está na branch principal (geralmente chamada de main ou master).
-
Abra o terminal no seu computador.
-
Navegue até a pasta do seu projeto GitCaos. Use o comando
cd caminho/do/seu/projetopara acessar a pasta correta. -
Verifique o estado atual do seu repositório com o comando:
git status
Você verá algo como:
On branch main Your branch is up to date with 'origin/main'. nothing to commit, working tree clean -
Identifique o número da issue. Como você já tem o link da issue, o número estará no final da URL. Por exemplo, se a URL da issue for
https://github.com/cumbucadev/gitcaos/issues/15, o número da issue é 15. -
Crie um novo branch usando apenas o número da issue:
git checkout -b 15
-
Verifique o estado do repositório após a criação do branch com:
git status
O resultado deve ser semelhante a:
On branch 15 Switched to a new branch '15' nothing to commit, working tree clean
Agora que você está no seu novo branch, é hora de fazer as alterações necessárias no código ou na documentação. As alterações devem ser feitas seguindo as instruções que estão especificadas na issue que você está resolvendo.
- Abra o projeto em um editor de texto ou IDE.
- Siga as instruções da issue.
Após realizar as modificações, você pode continuar para o próximo passo.
Depois de fazer as alterações, você precisa adicioná-las ao seu branch. Isso informa ao Git quais alterações você deseja incluir no próximo commit.
-
Verifique o estado do seu repositório com:
git status
O resultado mostrará que o arquivo foi modificado, algo como:
On branch 15 Changes not staged for commit: modified: seu-username.txt -
Adicione suas alterações usando o comando:
git add caos/O_JOGO_DO_TIGRINHO_ME_DEU.md
-
Verifique novamente o estado do repositório com:
git status
O resultado agora mostrará que o arquivo foi adicionado:
On branch 15 Changes to be committed: new file: seu-username.txt
Agora é hora de salvar suas alterações no histórico do Git. Para isso, você deve "commitar" suas alterações.
-
Realize o commit com o seguinte comando: (Substitua
seu-usernamepelo seu nome de usuário do GitHub. Essa mensagem ajuda outros a entenderem rapidamente o que foi alterado.)git commit -m "Novo arquivo: seu-username.txt"
Depois de realizar o commit, suas alterações estão salvas no histórico do Git, prontas para serem enviadas para o seu repositório no GitHub.
Depois de realizar o commit das suas alterações, é hora de enviá-las para o repositório remoto no GitHub. Esse processo é chamado de push.
-
Abra o terminal (ou o prompt de comando).
-
Navegue até o diretório do seu projeto se você ainda não estiver lá:
cd caminho/para/seu/projeto -
Execute o comando de push para o branch específico (substitua
15pelo nome do branch que você criou):git push origin 15
Após fazer o commit, você precisa criar um Pull Request (PR) para que suas alterações possam ser revisadas e eventualmente mescladas à branch principal. Lembre-se de que você deve fazer isso no seu fork do repositório GitCaos.
Nota importante: Cada tarefa deve ser enviada em um Pull Request (PR) separado para facilitar a revisão. Por favor, crie um PR específico para essa tarefa.
-
Acesse o GitHub e vá até o seu repositório forkado do GitCaos.
-
Localize o branch que você acabou de criar. Você verá uma opção para criar um Pull Request.
-
Clique em "Compare & pull request".
-
Preencha o título e a descrição do PR:
-
Título: "Tarefa 2: Jogo do tigrinho - seu-username" (substitua
seu-usernamepelo seu nome de usuário). -
Descrição: (Substitua
15pelo número da issue que você está resolvendo, que pode ser encontrado no final da URL da issue.)Tarefa 2: - Jogo do tigrinho - seu-username adicionado Closes #15
-
-
Clique em "Create pull request" para finalizar.
Pronto! Agora sua contribuição será revisada por outros colaboradores do projeto GitCaos.
Ações: