History

leestott 3a46c7dc91 🌐 Update translations via Co-op Translator		1 week ago
..
README.md	🌐 Update translations via Co-op Translator	1 week ago

README.md

Introdução ao GitHub

Esta lição aborda os fundamentos do GitHub, uma plataforma para hospedar e gerenciar alterações no seu código.

Sketchnote por Tomomi Imura

Quiz Pré-Aula

Quiz pré-aula

Introdução

Nesta lição, vamos abordar:

como rastrear o trabalho que você faz na sua máquina
como trabalhar em projetos com outras pessoas
como contribuir para software de código aberto

Pré-requisitos

Antes de começar, você precisa verificar se o Git está instalado. No terminal, digite: git --version

Se o Git não estiver instalado, baixe o Git. Em seguida, configure seu perfil local do Git no terminal:

git config --global user.name "seu-nome"
git config --global user.email "seu-email"

Para verificar se o Git já está configurado, você pode digitar: git config --list

Você também precisará de uma conta no GitHub, um editor de código (como o Visual Studio Code) e deverá abrir seu terminal (ou prompt de comando).

Acesse github.com e crie uma conta, caso ainda não tenha uma, ou faça login e preencha seu perfil.

✅ O GitHub não é o único repositório de código no mundo; existem outros, mas o GitHub é o mais conhecido.

Preparação

Você precisará de uma pasta com um projeto de código na sua máquina local (laptop ou PC) e de um repositório público no GitHub, que servirá como exemplo de como contribuir para os projetos de outras pessoas.

Gerenciamento de código

Vamos supor que você tenha uma pasta localmente com algum projeto de código e queira começar a rastrear seu progresso usando o Git - o sistema de controle de versão. Algumas pessoas comparam usar o Git a escrever uma carta de amor para seu futuro eu. Ao ler suas mensagens de commit dias, semanas ou meses depois, você será capaz de lembrar por que tomou uma decisão ou "reverter" uma alteração - isso, claro, quando você escreve boas mensagens de commit.

Tarefa: Criar um repositório e fazer commit de código

Confira o vídeo

Criar repositório no GitHub. No GitHub.com, na aba de repositórios ou na barra de navegação no canto superior direito, encontre o botão novo repositório.
1. Dê um nome ao seu repositório (pasta).
2. Selecione criar repositório.
Navegar até sua pasta de trabalho. No terminal, vá até a pasta (também conhecida como diretório) que você deseja começar a rastrear. Digite:
```
cd [name of your folder]
```
Inicializar um repositório Git. No seu projeto, digite:
```
git init
```
Verificar status. Para verificar o status do seu repositório, digite:
```
git status
```
A saída pode ser algo como:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Normalmente, o comando git status informa coisas como quais arquivos estão prontos para serem salvos no repositório ou têm alterações que você pode querer persistir.
Adicionar todos os arquivos para rastreamento Isso também é chamado de "estágio de arquivos" ou "adicionar arquivos à área de preparação".
```
git add .
```
O argumento git add seguido de . indica que todos os seus arquivos e alterações serão rastreados.
Adicionar arquivos selecionados para rastreamento
```
git add [file or folder name]
```
Isso nos ajuda a adicionar apenas arquivos selecionados à área de preparação quando não queremos fazer commit de todos os arquivos de uma vez.
Remover todos os arquivos da área de preparação
```
git reset
```
Este comando nos ajuda a remover todos os arquivos da área de preparação de uma vez.
Remover um arquivo específico da área de preparação
```
git reset [file or folder name]
```
Este comando nos ajuda a remover apenas um arquivo específico da área de preparação que não queremos incluir no próximo commit.
Persistir seu trabalho. Neste ponto, você adicionou os arquivos a uma chamada área de preparação. Um lugar onde o Git está rastreando seus arquivos. Para tornar a alteração permanente, você precisa fazer commit dos arquivos. Para isso, crie um commit com o comando git commit. Um commit representa um ponto de salvamento na história do seu repositório. Digite o seguinte para criar um commit:
```
git commit -m "first commit"
```
Isso faz commit de todos os seus arquivos, adicionando a mensagem "primeiro commit". Para mensagens de commit futuras, você vai querer ser mais descritivo na sua descrição para transmitir o tipo de alteração que você fez.
Conectar seu repositório Git local ao GitHub. Um repositório Git é útil na sua máquina, mas em algum momento você vai querer ter um backup dos seus arquivos em algum lugar e também convidar outras pessoas para trabalhar com você no repositório. Um ótimo lugar para isso é o GitHub. Lembre-se de que já criamos um repositório no GitHub, então só precisamos conectar nosso repositório Git local ao GitHub. O comando git remote add fará isso. Digite o seguinte comando:

Nota: antes de digitar o comando, vá até a página do repositório no GitHub para encontrar a URL do repositório. Você usará essa URL no comando abaixo. Substitua https://github.com/username/repository_name.git pela URL do GitHub.
```
git remote add origin https://github.com/username/repository_name.git
```
Isso cria um remote, ou conexão, chamado "origin", apontando para o repositório do GitHub que você criou anteriormente.
Enviar arquivos locais para o GitHub. Até agora, você criou uma conexão entre o repositório local e o repositório do GitHub. Vamos enviar esses arquivos para o GitHub com o seguinte comando git push, assim:

Nota: o nome da sua branch pode ser diferente por padrão de main.
```
git push -u origin main
```
Isso envia seus commits na branch "main" para o GitHub.
Adicionar mais alterações. Se você quiser continuar fazendo alterações e enviá-las para o GitHub, só precisará usar os seguintes três comandos:
```
git add .
git commit -m "type your commit message here"
git push
```
Dica: você também pode adotar um arquivo .gitignore para evitar que arquivos que você não deseja rastrear apareçam no GitHub - como aquele arquivo de notas que você armazena na mesma pasta, mas que não tem lugar em um repositório público. Você pode encontrar modelos para arquivos .gitignore em .gitignore templates.

Mensagens de commit

Uma ótima linha de assunto para um commit no Git completa a seguinte frase: Se aplicado, este commit irá

Para o assunto, use o imperativo no presente: "alterar" e não "alterado" nem "altera". Assim como no assunto, no corpo (opcional) também use o imperativo no presente. O corpo deve incluir a motivação para a alteração e contrastá-la com o comportamento anterior. Você está explicando o porquê, não o como.

✅ Reserve alguns minutos para navegar pelo GitHub. Você consegue encontrar uma mensagem de commit realmente boa? Consegue encontrar uma bem minimalista? Quais informações você acha que são mais importantes e úteis para transmitir em uma mensagem de commit?

Tarefa: Colaborar

O principal motivo para colocar coisas no GitHub foi tornar possível colaborar com outros desenvolvedores.

Trabalhando em projetos com outras pessoas

Confira o vídeo

No seu repositório, navegue até Insights > Community para ver como seu projeto se compara aos padrões recomendados para a comunidade.

Aqui estão algumas coisas que podem melhorar seu repositório no GitHub:

Descrição. Você adicionou uma descrição para o seu projeto?
README. Você adicionou um README? O GitHub fornece orientações para escrever um README.
Diretrizes de contribuição. Seu projeto tem diretrizes de contribuição?
Código de Conduta. Um Código de Conduta.
Licença. Talvez o mais importante, uma licença?

Todos esses recursos beneficiarão a integração de novos membros da equipe. E essas são, geralmente, as coisas que novos contribuidores olham antes mesmo de olhar para o seu código, para descobrir se seu projeto é o lugar certo para eles investirem seu tempo.

✅ Arquivos README, embora levem tempo para serem preparados, são frequentemente negligenciados por mantenedores ocupados. Você consegue encontrar um exemplo de um README particularmente descritivo? Nota: existem alguns ferramentas para ajudar a criar bons READMEs que você pode querer experimentar.

Tarefa: Fazer merge de código

Documentos de contribuição ajudam as pessoas a contribuir para o projeto. Eles explicam quais tipos de contribuições você está procurando e como o processo funciona. Os contribuidores precisarão passar por uma série de etapas para poder contribuir para seu repositório no GitHub:

Fazer fork do seu repositório. Você provavelmente vai querer que as pessoas façam fork do seu projeto. Fazer fork significa criar uma réplica do seu repositório no perfil delas no GitHub.
Clonar. A partir daí, elas irão clonar o projeto para sua máquina local.
Criar uma branch. Você vai querer pedir que elas criem uma branch para o trabalho delas.
Focar a alteração em uma área. Peça aos contribuidores para concentrarem suas contribuições em uma coisa de cada vez - assim, as chances de você conseguir fazer merge do trabalho deles são maiores. Imagine que eles escrevam uma correção de bug, adicionem um novo recurso e atualizem vários testes - e se você quiser ou puder implementar apenas 2 de 3 ou 1 de 3 alterações?

✅ Imagine uma situação onde branches são particularmente críticas para escrever e entregar um bom código. Quais casos de uso você consegue pensar?

Nota: seja a mudança que você quer ver no mundo e crie branches para seu próprio trabalho também. Qualquer commit que você fizer será feito na branch que você está atualmente "checado". Use git status para ver em qual branch você está.

Vamos passar por um fluxo de trabalho de contribuidores. Assuma que o contribuidor já fez fork e clonou o repositório, então ele tem um repositório Git pronto para ser trabalhado na máquina local:

Criar uma branch. Use o comando git branch para criar uma branch que conterá as alterações que ele pretende contribuir:
```
git branch [branch-name]
```
Trocar para a branch de trabalho. Troque para a branch especificada e atualize o diretório de trabalho com git switch:
```
git switch [branch-name]
```
Fazer o trabalho. Neste ponto, você quer adicionar suas alterações. Não se esqueça de informar ao Git sobre isso com os seguintes comandos:
```
git add .
git commit -m "my changes"
```
Certifique-se de dar um bom nome ao seu commit, para seu próprio benefício e para o mantenedor do repositório que você está ajudando.
Combinar seu trabalho com a branch main. Em algum momento, você termina o trabalho e quer combinar seu trabalho com o da branch main. A branch main pode ter mudado enquanto isso, então certifique-se de primeiro atualizá-la para a versão mais recente com os seguintes comandos:
```
git switch main
git pull
```
Neste ponto, você quer garantir que quaisquer conflitos, situações onde o Git não consegue facilmente combinar as alterações, aconteçam na sua branch de trabalho. Portanto, execute os seguintes comandos:
```
git switch [branch_name]
git merge main
```
Isso trará todas as alterações da branch main para sua branch e, com sorte, você poderá continuar. Se não, o VS Code mostrará onde o Git está confuso e você apenas alterará os arquivos afetados para indicar qual conteúdo é o mais preciso.
Enviar seu trabalho para o GitHub. Enviar seu trabalho para o GitHub significa duas coisas: enviar sua branch para seu repositório e, em seguida, abrir um PR (Pull Request).
```
git push --set-upstream origin [branch-name]
```
O comando acima cria a branch no seu repositório de fork.
Abrir um PR. Em seguida, você quer abrir um PR. Você faz isso navegando até o repositório de fork no GitHub. Você verá uma indicação no GitHub perguntando se deseja criar um novo PR, clique nisso e você será levado a uma interface onde pode alterar o título da mensagem de commit, dar uma descrição mais adequada. Agora o mantenedor do repositório que você fez fork verá este PR e dedos cruzados ele apreciará e fará merge do seu PR. Você agora é um contribuidor, yay :)
Limpar. É considerado uma boa prática limpar após você ter feito merge com sucesso de um PR. Você quer limpar tanto sua branch local quanto a branch que você enviou para o GitHub. Primeiro, vamos deletá-la localmente com o seguinte comando:
```
git branch -d [branch-name]
```
Certifique-se de ir à página do repositório de fork no GitHub e remover a branch remota que você acabou de enviar. Pull request pode parecer um termo estranho, porque na verdade você quer enviar suas alterações para o projeto. Mas o mantenedor (dono do projeto) ou a equipe principal precisa avaliar suas alterações antes de integrá-las ao branch "main" do projeto. Então, você está realmente solicitando uma decisão de mudança ao mantenedor.

Um pull request é o lugar para comparar e discutir as diferenças introduzidas em um branch, com revisões, comentários, testes integrados e mais. Um bom pull request segue aproximadamente as mesmas regras de uma mensagem de commit. Você pode adicionar uma referência a um problema no rastreador de problemas, por exemplo, quando seu trabalho resolve um problema. Isso é feito usando um # seguido pelo número do problema. Por exemplo, #97.

🤞Dedos cruzados para que todos os testes passem e o(s) dono(s) do projeto integrem suas alterações ao projeto🤞

Atualize seu branch local atual com todos os novos commits do branch remoto correspondente no GitHub:

git pull

Como contribuir para código aberto

Primeiro, vamos encontrar um repositório (ou repo) no GitHub que seja do seu interesse e para o qual você gostaria de contribuir com uma alteração. Você vai querer copiar o conteúdo dele para sua máquina.

✅ Uma boa maneira de encontrar repositórios 'amigáveis para iniciantes' é buscar pela tag 'good-first-issue'.

Existem várias maneiras de copiar código. Uma delas é "clonar" o conteúdo do repositório, usando HTTPS, SSH ou a CLI (Interface de Linha de Comando) do GitHub.

Abra seu terminal e clone o repositório assim: git clone https://github.com/ProjectURL

Para trabalhar no projeto, mude para a pasta correta: cd ProjectURL

Você também pode abrir o projeto inteiro usando Codespaces, o editor de código integrado/ambiente de desenvolvimento em nuvem do GitHub, ou GitHub Desktop.

Por fim, você pode baixar o código em uma pasta compactada.

Algumas coisas interessantes sobre o GitHub

Você pode dar estrela, seguir ou "forkar" qualquer repositório público no GitHub. Você encontra seus repositórios com estrela no menu suspenso no canto superior direito. É como salvar nos favoritos, mas para código.

Os projetos têm um rastreador de problemas, geralmente no GitHub na aba "Issues", a menos que indicado de outra forma, onde as pessoas discutem problemas relacionados ao projeto. E a aba Pull Requests é onde as pessoas discutem e revisam alterações que estão em andamento.

Os projetos também podem ter discussões em fóruns, listas de e-mails ou canais de chat como Slack, Discord ou IRC.

✅ Explore seu novo repositório no GitHub e experimente algumas coisas, como editar configurações, adicionar informações ao repositório e criar um projeto (como um quadro Kanban). Há muito o que fazer!

🚀 Desafio

Trabalhe em parceria com um amigo para trabalhar no código um do outro. Crie um projeto colaborativo, faça fork do código, crie branches e integre alterações.

Quiz Pós-Aula

Quiz pós-aula

Revisão & Autoestudo

Guia rápido de Git.

Pratique, pratique, pratique. O GitHub tem ótimos caminhos de aprendizado disponíveis via skills.github.com:

Primeira Semana no GitHub

Você também encontrará cursos mais avançados.

Tarefa

Complete o curso Primeira Semana no GitHub

Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte oficial. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.