https://github.com/danielobara/mentoriagithub

Repositório criado para auxiliar os alunos da Gama Academy nas aulas de Github.
https://github.com/danielobara/mentoriagithub

acessibilidade comandos-git github itau pdc tutorial-github

Last synced: 2 months ago
JSON representation

Repositório criado para auxiliar os alunos da Gama Academy nas aulas de Github.

• Host: GitHub
• URL: https://github.com/danielobara/mentoriagithub
• Owner: DanielObara
• Created: 2020-11-19T12:22:47.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-10-11T23:18:27.000Z (over 3 years ago)
• Last Synced: 2025-04-10T23:03:05.098Z (2 months ago)
• Topics: acessibilidade, comandos-git, github, itau, pdc, tutorial-github
• Language: HTML
• Homepage:
• Size: 408 KB
• Stars: 23
• Watchers: 1
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


    





  

	

  

    

  

  

    

  

  

   

    

  



## Resumidão (do clone ao push)

Se você já sabe executar todo o fluxo e só quer relembrar, deixo abaixo o fluxo (básico e sem criação de branch) resumido mas se voce quiser saber detalhadamente recomendo prosseguir a leitura.

```bash

# Clone o repositório

$ git clone https://github.com/DanielObara/MentoriaGitHub

# Modifique algo e adicione ao stage

$ git add .

# Commite com a mensagem do que fez, siga o commitlint!

$ git commit -m "feat(lang): add portuguese language"

# Suba suas alterações

$ git push

```

## Criando um novo repositório:

Crie uma nova pasta, abra-a e no terminal execute o comando

```bash

$ git init

```

## Clonando um repositório:

Crie uma cópia de trabalho em um repositório local executando o comando:

```bash

$ git clone /caminho/para/o/repositório

```

Quando usar um servidor remoto, por exemplo o GitHub, seu comando será:

```bash

$ git clone https://github.com/DanielObara/MentoriaGitHub

```

O endereço do servidor remoto (repositório) o endereço (link) você pode obter clicando no botão code na página do repositório. 

Exemplo abaixo:



  



Para acessar o projeto recém clonado, acesse a pasta do projeto e caso tenha acessado via terminal digite:

```bash 

$ code .

```

Caso não seja via terminal clique com o botão direito dentro da pasta e veja se tem a opção de abrir no VSCode.

## Atualizando o repositório remoto:

Seus repositórios locais consistem em três "árvores" mantidas pelo git. A primeira delas é sua Working Directory que contém os arquivos atuais, a segunda Index / Stage que funciona como uma área temporária e finalmente a HEAD que aponta para o último commit (confirmação) que você fez.



  



## Adicionar & Confirmar

Você pode propor mudanças (adicioná-las ao Index) usando:

```bash

# Para adicionar um arquivo em particular

$ git add caminho/até/o/arquivo

# Ou para adicionar todas as alterações:

$ git add .

# ou pode-se usar *

$ git add *

```

Este é o primeiro passo no fluxo de atualizar o repositorio de forma básica do git. 

Para realmente confirmar estas mudanças (isto é, fazer um commit), use:

```bash

$ git commit -m "Mensagem dizendo o que eu fiz nessas alterações"

```

**Obs: recomendo seguir a convenção de commit conhecida como conventional changelog ou [commitlint](https://github.com/conventional-changelog/commitlint)

Agora o arquivo é enviado para o HEAD, mas ainda não foi enviado para o repositório remoto (aquele lá nos servidores/nuvem do Github).

## Enviando as alterações:

Lembre-se que suas alterações agora estão no HEAD da sua cópia do repositório local. 

Para enviar estas alterações ao seu repositório remoto, execute

```bash

$ git push origin main

```

Altere main para qualquer ramo (branch) desejado, enviando suas alterações para branch específica. Caso não especifique qual branch, o git entenderá por padrão a branch atual que você estiver.

Se você não clonou de um repositório que já existe e quer conectar seu repositório a um no servidor remoto (GitHub por exemplo), você deve adicioná-lo com

```bash

$ git remote add origin 

```

Ficaria assim:

  

```bash

$ git remote add origin [email protected]:DanielObara/MentoriaGitHub.git

```

Agora você é capaz de enviar suas alterações para o servidor remoto selecionado.

## Criando o branch

Branches ("ramos") são utilizados para desenvolver funcionalidades isoladas umas das outras. O branch main é o branch "padrão" quando você cria um repositório. Use outros branches para desenvolver e junte-os (merge) ao branch main após a conclusão.

Por questão de padrão de nomenclatura costumo nomear as branchs com prefixo do que ela significa. Por exemplo:

- bugfix/

 
Branch de um bug que necessita ser corrigido.


- feature/

Uma nova feature que será adicionada ao projeto.


- refactor/

Quando precisamos fazer uma melhoria em algum trecho do código


- doc/

Quando fazemos alguma alteração ou criação de documentações


Crie um novo branch chamado "feature/Navbar" e selecione-o usando:

  

```bash

$ git checkout -b doc/CreateBranchSection

```

retorne para o main usando

  

```bash

$ git checkout main

```

e remova o branch da seguinte forma

  

```bash

$ git branch -d doc/CreateBranchSection

```

Um branch não está disponível aos outros a menos que você envie o branch para seu repositório remoto.

Ao tentar efetuar o push, receberá a seguinte mensagem no terminal:



  



```bash

$ git push --set-upstream origin doc/CreateBranchSection

```

Após isso a branch será enviada ao repositório remoto e você obterá a seguinte resposta em seu terminal:



  



Pronto! Seu branch foi enviada ao remoto e só falta você ir no github e fazer um pull request.

## Fazendo o Pull Request

Para fazer o pull request utilizaremos a interface web do github.

Acesse o repositório que deseja fazer o Pull Request, é necessário que tenha feito os passos anteriores (criação do branch, add, commit e push), haverá uma nova caixa de informação informando que seu branch teve alterações recentes e um botão para comparar e solicitar um pull request.



  



Ao clicar no botão será redirecionado para uma nova página onde haverá um campo para colocar o título e a descrição da sua solicitação.

Caso queira poderá selecionar quais as branchs quer mesclar, mas por padrão já fica selecionado a main com a sua branch. (base: main <- compare: NomeDaSuaBranch)

Depois disso só clicar em Create Pull Request ou Criar pull request caso esteja em português.



  



Há mais informações na tela no qual você poderá atribuir a quem quer que faça a revisão, de quem é a tarefa ou assinar à alguém, labels, de qual projeto etc. 

**Observação: Caso sua branch esteja com código em andamento, poderá colocar no início do título a sigla WIP que significa Work in Progress, ou seja a pessoa responsável por aceitar seu pull request não ira mesclar até que esteja finalizado.

## Atualizar & mesclar (merge)

Para atualizar seu repositório local com a versão mais nova, na sua pasta de trabalho e via terminal execute o comando:

```bash

$ git pull

```

Para fazer merge de um outro branch ao seu branch ativo. 

Supondo que você esteja na main e quer mesclar a branch doc/CreateBranchSection na main, use:

```bash

$ git merge doc/CreateBranchSection

```

Ou pode ser o inverso, atualizar a sua branch com a main.

Em ambos os casos o git tenta fazer o merge das alterações automaticamente.

Infelizmente, isto nem sempre é possível e resulta em conflitos. Você é responsável por fazer o merge estes conflitos manualmente editando os arquivos exibidos pelo git. Depois de alterar, você precisa marcá-los como merged com o seguinte comando:

```bash

$ git add .

# Ou

$ git add 

```

Antes de fazer o merge das alterações, você pode também pré-visualizá-as usando

```bash

$ git diff  

# ficaria assim: 

$ git diff doc/UpdateAndMerge main

```

## Qual a situação atual (git status)?

Para verificar o que foi feito e qual a situação (Se está atualizado ou se tem modificações) execute o comando abaixo:

```bash

$ git status

```

Após executar git status você verá qual branch se encontra e quais as alterações e arquivos não monitorados pelo git.



  



## Como contribuir com este repositório?

- Crie um fork;

- Crie um branch com suas features: `git checkout -b feature/my-feature`;

- Commit suas alterações: `git commit -m 'feat: My new feature'`;

- Faça um push com a sua branch `git push origin my-feature`;

- Crie um pull request no GitHub.

Após mergeado voce receberá a mensagem de que foi concluído e poderá deletar sua branch.

Made with ♥ by Daniel Obara :wave: [Get in touch!](https://www.linkedin.com/in/danielobara/)

Fontes: [Git](https://git-scm.com/), [rogerdudler](https://rogerdudler.github.io/git-guide/index.pt_BR.html) & [GitHub - Docs](https://docs.github.com/pt)