Pular para o conteúdo principal

Lab 00 — Git, GitHub e gh

🗺️ Mapa de tarefas — 17 tarefas · 100 pts (clique para expandir)
  • T1 — Salvar evidencias/git-config.txt com user.name e user.email configurados (5 pts)
  • T2 — Criar README.md com um cabecalho H1 e um paragrafo de introducao (5 pts)
  • T3 — Adicionar cabecalhos H2/H3, negrito, italico e codigo inline ao README.md (6 pts)
  • T4 — Adicionar lista nao-ordenada com sublista, lista ordenada e lista de tarefas ao README.md (6 pts)
  • T5 — Adicionar ao menos dois links e uma imagem (badge) ao README.md (5 pts)
  • T6 — Adicionar um bloco de codigo com identificacao de linguagem (ex. bash) ao README.md (5 pts)
  • T7 — Adicionar uma tabela Markdown com cabecalho e ao menos duas linhas ao README.md (5 pts)
  • T8 — Adicionar uma citacao e uma regra horizontal ao README.md (5 pts)
  • T9 — Adicionar um .gitignore que ignora arquivos temporarios e de sistema (5 pts)
  • T10 — Criar branch, fazer merge na main e salvar evidencias/git-branch.txt (8 pts)
  • T11 — Salvar evidencias/gh-auth.txt (login) e evidencias/gh-repo.txt (owner/nome/branch) (5 pts)
  • T12 — Montar o README.md final com sumario de ancoras e todas as secoes integradas (12 pts)
  • T13 — Publicar o release v1.0.0 com gh release create (8 pts)
  • T14 — Abrir um pull request com gh e salvar a URL em evidencias/gh-pr.txt (5 pts)
  • T15 — Abrir uma issue com gh e salvar a URL em evidencias/gh-issue.txt (5 pts)
  • T16 — Provocar e resolver um conflito de merge, mantendo as duas versoes em conflito.txt (5 pts)
  • T17 — Usar gh api para confirmar a tag do release e salvar evidencias/gh-api.txt (5 pts)

Total: 100 pts

Antes de começar

Confira o ambiente (faça a configuração uma vez por máquina; a verificação, a cada aula):

Verificação rápida das versões instaladas:

git -v & gh --version & code -v & py --version & pio --version & wokwi-cli -V & wsl --version & docker --version

Verificação rápida de autenticação e alias:

git config --get-regexp "^(user|alias)\." & gh auth status & code --list-extensions --profile "ESP32IO"

Adicionar o comando git conferir:

git config --global alias.conferir "!f() { r=$(pwd -W 2>/dev/null || pwd); echo raiz do repositorio: $r; test -z $GIT_PREFIX || echo ATENCAO: o terminal esta em $GIT_PREFIX, fora da raiz. Antes do git add, rode: cd /d $r; test $# -eq 0 && return; for a in $@; do if [ -e $a ]; then echo ok $a; else echo FALTA $a; fi; done; echo == mudancas desde o ultimo commit:; git status --short --ignored -- $@; }; f"

Ao terminar — máquina de laboratório

Antes de sair, faça logout para não deixar sua conta do GitHub ativa nesta máquina. Rode os comandos abaixo no Prompt de Comando (cmd), não no PowerShell.

1. Apague a credencial do GitHub salva pelo git, encerre a sessão do gh e remova seu nome e e-mail da configuração global:

(echo protocol=https&echo host=github.com) | git credential reject
gh auth logout --hostname github.com
git config --global --unset user.name
git config --global --unset user.email

Para conferir, este comando não deve mostrar nada:

cmdkey /list | findstr /i github

2. Pare os containers do lab:

for /f "delims=" %i in ('docker compose ls -q') do docker compose -p %i down

3. No navegador, saia da sua conta em github.com e feche todas as janelas.


Toda entrega do curso é feita por commit: cada tarefa avaliada vira um commit cuja mensagem começa com Tn:, e o autograder corrige exatamente o estado daquele commit. Antes de tudo, você precisa dominar a ferramenta de entrega. Neste Lab 00 você aprende git (versionamento local), GitHub (o remoto da organização), gh (o GitHub CLI) e Markdown — a linguagem em que se escreve todo README.md, issue e pull request do curso.

Clone o repositório inicial do LAB00​

Escolha o Grupo e entre com o comando abaixo para criar o repositório no GitHub:

1. Crie e entre na pasta-mãe da disciplina:

mkdir "%USERPROFILE%\ELT85BN21" & cd /d "%USERPROFILE%\ELT85BN21"

2. Clone e entre no repositório do laboratório:

git clone https://github.com/ELT85B-N21-2026-2/lab00-grupo-a.git && cd lab00-grupo-a

3. Abra o conteúdo do repositório no perfil ESP32IO do VS Code e compile:

cd /d "%USERPROFILE%\ELT85BN21\lab00-grupo-a" && code . --profile "ESP32IO"

Repositório do Grupo A para Laboratório 00:

  1. Copie o link do repositório acima.
  2. Abra a página de envio da atividade no Moodle (botão abaixo).
  3. Clique em Adicionar envio.
  4. Cole o link no campo Texto online.
  5. Clique em Salvar mudanças.
  6. Confira se o status mudou para Enviado para avaliação.
Abrir envio no Moodle
Avaliação por commits

Cada cartão Ponto de commit é uma tarefa: faça-a, copie o comando do cartão e rode. A mensagem começa com o código (T1:, T2:…) — é como a correção identifica sua entrega. Um commit por tarefa; pode refazer (vale o mais recente); e não esqueça o git push. Detalhes em Como funciona a avaliação.


Objetivos de aprendizagem​

Ao final você será capaz de:

  • Explicar o modelo do git: working tree → staging → repositório local → remoto.
  • Aplicar a convenção do curso: 1 tarefa = 1 commit, mensagem iniciando com Tn:.
  • Escrever Markdown com fluência: cabeçalhos, ênfase, listas, links, imagens, código, tabelas, citações e sumário com âncoras.
  • Produzir um README.md completo, legível e navegável.
  • Criar branches, fazer merge e resolver um conflito simples.
  • Usar gh para repo, pr, issue, release e api sem sair do terminal.

Material​

  • VS Code (editor). Recomendada a extensão Markdown All in One e o markdownlint para pré-visualizar e revisar o Markdown.
  • git instalado (git --version).
  • GitHub CLI (gh) instalado (gh --version) — série 2.x.
  • Conta no GitHub, membro da organização ELT85B-N21-2026-2.
  • Seu repositório de grupo: lab00-grupo-<sua-letra> (criado no passo acima).
Pré-visualize enquanto escreve

No VS Code, com um arquivo .md aberto, use Ctrl+Shift+V (ou o ícone de lupa no canto superior direito) para ver o Markdown renderizado lado a lado. É a forma mais rápida de conferir cada tarefa antes do commit.

O modelo mental do git​

Um commit é uma fotografia imutável do projeto num instante, com autor, data e mensagem. O git add escolhe o que entra na foto; o git commit tira a foto; o git push envia as fotos para o GitHub, onde o autograder as encontra.

A convenção do curso

Cada tarefa Tn = um commit cuja mensagem começa com Tn:. Exemplo: T1: registra identidade do git. Se precisar corrigir uma tarefa, refaça com um novo commit Tn: — vale sempre o Tn: mais recente. Nunca use push --force no repositório de grupo.

Configuração única vs. rotina de trabalho

Há dois ritmos no git. git config --global (sua identidade) é feito uma única vez por máquina — configura e esquece. Já git add → commit → push é a rotina que você repete a cada tarefa. Não confunda os dois: reconfigurar identidade a cada commit é desperdício; esquecer de commitar/enviar é perder a entrega.

Confira que você está dentro do repositório clonado antes de começar:

Terminal
cd lab00-grupo-a # troque pela letra do seu grupo
git status

Parte 1 — Primeiro commit e o título do README​

Objetivo: provar que sua identidade está correta e criar o README.md com um cabeçalho de nível 1.

Muitos passos desta aula são de runtime (rodam comandos, não editam arquivos "de conteúdo"). Para que o autograder possa checá-los, você salva a evidência da saída em evidencias/*.txt. Crie a pasta e registre a identidade:

Terminal
mkdir -p evidencias
git config --list | grep -E "user\.(name|email)" > evidencias/git-config.txt
cat evidencias/git-config.txt
git add evidencias/git-config.txt
git commit -m "T1: registra identidade do git"
Ponto de commit · T1 (5 pts) #

Salvar evidencias/git-config.txt com user.name e user.email configurados

1. Conferir os arquivos
git conferir evidencias/git-config.txt
2. Commit T1 e push
git add evidencias/git-config.txt && git commit -m "T1: Salvar evidencias/git-config.txt com user.name e user.email configurados" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T1.

O # no início de uma linha é um cabeçalho H1 — o título do documento. Crie o README.md com o título e um parágrafo de introdução:

README.md
# lab00 — grupo A

Repositório do grupo A para o Lab 00 (git, GitHub, gh e Markdown).
Terminal
git add README.md
git commit -m "T2: cria README com titulo e introducao"
Ponto de commit · T2 (5 pts) #

Criar README.md com um cabecalho H1 e um paragrafo de introducao

1. Conferir os arquivos
git conferir README.md
2. Commit T2 e push
git add README.md && git commit -m "T2: Criar README.md com um cabecalho H1 e um paragrafo de introducao" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T2.


Parte 2 — Markdown essencial​

Objetivo: os blocos de construção de qualquer texto em Markdown.

2.1 Cabeçalhos e ênfase​

O número de # define o nível do cabeçalho (H1 a H6). Para ênfase: **negrito**, *itálico* e `código inline` (crases).

README.md (adicione ao final)
## Sobre o grupo

Integrantes: **Fulano da Silva** e _Ciclana Souza_.
Usamos o comando `git status` o tempo todo.

### Contato

Dúvidas: abra uma _issue_ neste repositório.

Resultado renderizado — os # viram títulos de tamanhos diferentes, **...** fica em negrito, *...* em itálico e `...` aparece em fonte monoespaçada.

Terminal
git add README.md
git commit -m "T3: adiciona cabecalhos e enfase ao README"
Ponto de commit · T3 (6 pts) #

Adicionar cabecalhos H2/H3, negrito, italico e codigo inline ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T3 e push
git add README.md && git commit -m "T3: Adicionar cabecalhos H2/H3, negrito, italico e codigo inline ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T3.

2.2 Listas​

Três tipos: não-ordenada (-), ordenada (1.) e de tarefas (- [ ] / - [x]). A indentação cria sublistas.

README.md (adicione ao final)
## Ferramentas

- git
- GitHub CLI (gh)
- `gh pr`
- `gh issue`
- VS Code

## Passos para entregar

1. Editar o arquivo
2. `git add`
3. `git commit`

## Checklist

- [x] Repositório clonado
- [ ] README completo
Terminal
git add README.md
git commit -m "T4: adiciona listas ao README"
Ponto de commit · T4 (6 pts) #

Adicionar lista nao-ordenada com sublista, lista ordenada e lista de tarefas ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T4 e push
git add README.md && git commit -m "T4: Adicionar lista nao-ordenada com sublista, lista ordenada e lista de tarefas ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T4.

Link: [texto](url). Imagem: ![texto alternativo](url) — a imagem é um link com ! na frente. Um badge é só uma imagem cuja URL gera o selo.

README.md (adicione ao final)
## Referências

- [Documentação oficial do Git](https://git-scm.com/doc)
- [Manual do GitHub CLI](https://cli.github.com/manual/)

![Feito com Markdown](https://img.shields.io/badge/feito%20com-markdown-blue)
Terminal
git add README.md
git commit -m "T5: adiciona links e um badge ao README"
Ponto de commit · T5 (5 pts) #

Adicionar ao menos dois links e uma imagem (badge) ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T5 e push
git add README.md && git commit -m "T5: Adicionar ao menos dois links e uma imagem (badge) ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T5.


Parte 3 — Markdown para documentação técnica​

Objetivo: os recursos que tornam um README realmente útil.

3.1 Blocos de código​

Três crases abrem e fecham um bloco; a palavra após as crases define a linguagem (destaque de sintaxe). Isso é essencial para instruções de terminal.

README.md (adicione ao final)
## Como usar

Clone e entre na pasta:

```bash
git clone https://github.com/ELT85B-N21-2026-2/lab00-grupo-a.git
cd lab00-grupo-a
```
Bloco dentro de bloco

Para mostrar um bloco de código dentro de outro (como acima), o bloco externo usa quatro crases. Você raramente precisa disso — mas é útil ao documentar Markdown.

Terminal
git add README.md
git commit -m "T6: adiciona bloco de codigo com destaque de linguagem"
Ponto de commit · T6 (5 pts) #

Adicionar um bloco de codigo com identificacao de linguagem (ex. bash) ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T6 e push
git add README.md && git commit -m "T6: Adicionar um bloco de codigo com identificacao de linguagem (ex. bash) ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T6.

3.2 Tabelas​

Colunas separadas por |; a segunda linha (---) separa o cabeçalho e define o alinhamento (:---, :---:, ---:).

README.md (adicione ao final)
## Comandos essenciais

| Comando | O que faz |
| :----------- | :--------------------------- |
| `git status` | mostra o estado da árvore |
| `git add` | move mudanças para o staging |
| `git commit` | grava um commit |

Resultado renderizado:

ComandoO que faz
git statusmostra o estado da árvore
git addmove mudanças para o staging
git commitgrava um commit
Terminal
git add README.md
git commit -m "T7: adiciona uma tabela ao README"
Ponto de commit · T7 (5 pts) #

Adicionar uma tabela Markdown com cabecalho e ao menos duas linhas ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T7 e push
git add README.md && git commit -m "T7: Adicionar uma tabela Markdown com cabecalho e ao menos duas linhas ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T7.

3.3 Citações e regra horizontal​

> cria uma citação; três hífens (---) numa linha isolada criam uma régua horizontal que separa seções.

README.md (adicione ao final)
---

> Versione cedo, versione com frequência.

Este repositório segue a convenção `Tn:` de commits do curso.
Terminal
git add README.md
git commit -m "T8: adiciona citacao e regra horizontal"
Ponto de commit · T8 (5 pts) #

Adicionar uma citacao e uma regra horizontal ao README.md

1. Conferir os arquivos
git conferir README.md
2. Commit T8 e push
git add README.md && git commit -m "T8: Adicionar uma citacao e uma regra horizontal ao README.md" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T8.


Parte 4 — Fluxo de trabalho no git​

Objetivo: ignorar o que não deve ser versionado e integrar trabalho por branches.

4.1 O .gitignore​

Nem tudo entra no git: arquivos temporários do sistema e do editor devem ser ignorados. Crie:

.gitignore
# Sistema operacional
.DS_Store
Thumbs.db
# Temporários
*.tmp
*.log
# VS Code (mantém apenas as extensões recomendadas)
.vscode/*
!.vscode/extensions.json
Terminal
git add .gitignore
git commit -m "T9: adiciona .gitignore"
Ponto de commit · T9 (5 pts) #

Adicionar um .gitignore que ignora arquivos temporarios e de sistema

1. Conferir os arquivos
git conferir .gitignore
2. Commit T9 e push
git add .gitignore && git commit -m "T9: Adicionar um .gitignore que ignora arquivos temporarios e de sistema" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T9.

4.2 Branch e merge​

Isole uma mudança num branch, integre-a à main e salve a evidência:

Terminal
git switch -c docs
echo "" >> README.md
echo "## Licença" >> README.md
echo "Uso educacional — ELT85B." >> README.md
git commit -am "wip: secao de licenca no branch docs"

git switch main
git merge docs
git branch --all > evidencias/git-branch.txt
git add evidencias/git-branch.txt
git commit -m "T10: integra branch docs na main"
Ponto de commit · T10 (8 pts) #

Criar branch, fazer merge na main e salvar evidencias/git-branch.txt

1. Conferir os arquivos
git conferir evidencias/git-branch.txt
2. Commit T10 e push
git add evidencias/git-branch.txt && git commit -m "T10: Criar branch, fazer merge na main e salvar evidencias/git-branch.txt" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T10.


Parte 5 — GitHub pelo terminal (gh)​

Objetivo: operar o repositório remoto sem abrir o navegador.

Terminal
gh auth status 2> evidencias/gh-auth.txt
gh repo view --json name,owner,defaultBranchRef \
--jq '"repo=\(.owner.login)/\(.name) branch=\(.defaultBranchRef.name)"' \
> evidencias/gh-repo.txt
cat evidencias/gh-auth.txt evidencias/gh-repo.txt
git add evidencias/gh-auth.txt evidencias/gh-repo.txt
git commit -m "T11: comprova auth e inspeciona o repo com gh"
evidencias/gh-repo.txt — saída esperada
repo=ELT85B-N21-2026-2/lab00-grupo-a branch=main
Ponto de commit · T11 (5 pts) #

Salvar evidencias/gh-auth.txt (login) e evidencias/gh-repo.txt (owner/nome/branch)

1. Conferir os arquivos
git conferir evidencias/gh-auth.txt evidencias/gh-repo.txt
2. Commit T11 e push
git add evidencias/gh-auth.txt evidencias/gh-repo.txt && git commit -m "T11: Salvar evidencias/gh-auth.txt (login) e evidencias/gh-repo.txt (owner/nome/branch)" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T11.

git push de verdade

Até aqui os commits estão no seu repositório local. Envie-os: git push. Confira no GitHub (ou com gh repo view --web) que os commits T1…T11 chegaram.


Projeto integrador — o README completo​

Objetivo: juntar todos os elementos num README.md bem estruturado, com sumário navegável.

Um bom README começa com um sumário (lista de links para âncoras). A âncora de um cabeçalho é o texto em minúsculas, com espaços virando hífens: ## Como usar vira o link [Como usar](#como-usar).

README.md — estrutura final sugerida
# lab00 — grupo A

Repositório do grupo A para o Lab 00.

## Sumário

- [Sobre o grupo](#sobre-o-grupo)
- [Ferramentas](#ferramentas)
- [Como usar](#como-usar)
- [Comandos essenciais](#comandos-essenciais)
- [Licença](#licença)

## Sobre o grupo

...

Revise o README.md para que ele contenha, de forma coerente: título (H1), sumário com âncoras, e seções usando cabeçalhos, listas, links, um badge, um bloco de código e uma tabela.

Terminal
git add README.md
git commit -m "T12: monta o README final com sumario e ancoras"
git push
Ponto de commit · T12 (12 pts) #

Montar o README.md final com sumario de ancoras e todas as secoes integradas

1. Conferir os arquivos
git conferir README.md
2. Commit T12 e push
git add README.md && git commit -m "T12: Montar o README.md final com sumario de ancoras e todas as secoes integradas" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T12.

Release — publicar uma versão​

O mesmo release que sustenta as tarefas de deploy das próximas aulas:

Terminal
git tag -a v1.0.0 -m "Lab 00 concluido"
git push origin v1.0.0
gh release create v1.0.0 \
--title "Lab 00 — v1.0.0" \
--notes "README em Markdown concluido."
git commit --allow-empty -m "T13: publica release v1.0.0"
git push
Ponto de commit · T13 (8 pts) #

Publicar o release v1.0.0 com gh release create

1. Conferir os arquivos
git conferir
2. Commit T13 e push
git commit --allow-empty -m "T13: Publicar o release v1.0.0 com gh release create" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório). No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado).


Desafios​

Valem pontos e reforçam o fluxo

Cada desafio é uma tarefa = um commit Tn:. Salve a evidência pedida.

D1 — Melhoria via Pull Request​

Proponha uma melhoria no README por um branch e um PR, em vez de commitar direto na main:

Terminal
git switch -c feature/emojis
echo "" >> README.md
echo "## Status" >> README.md
echo "Projeto concluido. :rocket:" >> README.md
git commit -am "wip: secao de status"
git push -u origin feature/emojis

gh pr create --base main --head feature/emojis \
--title "T14: adiciona secao de status ao README" \
--body "Nova secao Status. Fecha a tarefa T14." \
> evidencias/gh-pr.txt
gh pr merge --merge --delete-branch
git switch main && git pull
git add evidencias/gh-pr.txt
git commit -m "T14: registra o pull request criado"
git push
Ponto de commit · T14 (5 pts) #

Abrir um pull request com gh e salvar a URL em evidencias/gh-pr.txt

1. Conferir os arquivos
git conferir evidencias/gh-pr.txt
2. Commit T14 e push
git add evidencias/gh-pr.txt && git commit -m "T14: Abrir um pull request com gh e salvar a URL em evidencias/gh-pr.txt" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T14.

D2 — Uma issue pelo terminal​

Terminal
gh issue create --title "Adicionar screenshots ao README" \
--body "O README ficaria mais claro com imagens." > evidencias/gh-issue.txt
gh issue list > evidencias/gh-issue-list.txt
git add evidencias/gh-issue.txt evidencias/gh-issue-list.txt
git commit -m "T15: cria issue com gh"
git push
Ponto de commit · T15 (5 pts) #

Abrir uma issue com gh e salvar a URL em evidencias/gh-issue.txt

1. Conferir os arquivos
git conferir evidencias/gh-issue.txt
2. Commit T15 e push
git add evidencias/gh-issue.txt && git commit -m "T15: Abrir uma issue com gh e salvar a URL em evidencias/gh-issue.txt" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T15.

D3 — Resolver um conflito de merge​

Crie um conflito proposital em conflito.txt e resolva-o, mantendo as duas informações (sem os marcadores <<<<<<<):

Terminal
git switch -c ladoA; echo "estilo do README: minimalista" > conflito.txt
git add conflito.txt; git commit -m "wip: ladoA"
git switch main; git switch -c ladoB; echo "estilo do README: detalhado" > conflito.txt
git add conflito.txt; git commit -m "wip: ladoB"
git switch main; git merge ladoA; git merge ladoB # conflito aqui
# edite conflito.txt para: "estilo do README: minimalista e detalhado" e remova os marcadores
git add conflito.txt; git commit -m "T16: resolve conflito de merge"
git push
Ponto de commit · T16 (5 pts) #

Provocar e resolver um conflito de merge, mantendo as duas versoes em conflito.txt

1. Conferir os arquivos
git conferir conflito.txt
2. Commit T16 e push
git add conflito.txt && git commit -m "T16: Provocar e resolver um conflito de merge, mantendo as duas versoes em conflito.txt" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T16.

D4 — gh api: falar direto com a API​

O gh api chama a REST/GraphQL do GitHub autenticado. Confirme, via API, que seu release existe:

Terminal
gh api repos/{owner}/{repo}/releases/tags/v1.0.0 --jq '.tag_name' \
> evidencias/gh-api.txt
cat evidencias/gh-api.txt # deve imprimir: v1.0.0
git add evidencias/gh-api.txt
git commit -m "T17: consulta o release via gh api"
git push
Ponto de commit · T17 (5 pts) #

Usar gh api para confirmar a tag do release e salvar evidencias/gh-api.txt

1. Conferir os arquivos
git conferir evidencias/gh-api.txt
2. Commit T17 e push
git add evidencias/gh-api.txt && git commit -m "T17: Usar gh api para confirmar a tag do release e salvar evidencias/gh-api.txt" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório) nem FALTA. Nas mudanças, ?? é arquivo novo e M, modificado: os dois entram no commit. !! é arquivo bloqueado pelo .gitignore, e o git add vai falhar. Um arquivo que não aparece ali já está no Git e não mudou desde o último commit. No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado), e a lista tem de trazer os arquivos da T17.


Gabarito​

Spoiler

Tente sozinho antes de abrir. O Markdown e o fluxo git/gh desta aula são pré-requisito de todas as próximas.

Sintaxe Markdown de referência
Referência — sintaxe Markdown
# H1 ## H2 ### H3

**negrito** _italico_ `codigo inline`

- item (lista nao-ordenada)

1. item (lista ordenada)

- [ ] tarefa - [x] feita

[texto](https://url) (link)
![alt](https://url/img.png) (imagem / badge)

​`bash
git status
​`

| A | B | (tabela) |
| --- | --- | -------- |
| 1 | 2 |

> citacao
> --- (regra horizontal)

[Ir para secao](#como-usar) (ancora: minusculas, espacos viram hifen)
Comandos de referência (T1…T17)
Referência — sequência completa
# T1 identidade
mkdir -p evidencias
git config --list | grep -E "user\.(name|email)" > evidencias/git-config.txt
git add evidencias/git-config.txt && git commit -m "T1: registra identidade do git"

# T2..T8 edicoes no README.md (titulo, enfase, listas, links, codigo, tabela, citacao)
# cada bloco -> git add README.md && git commit -m "Tn: ..."

# T9 .gitignore
git add .gitignore && git commit -m "T9: adiciona .gitignore"

# T10 branch + merge
git switch -c docs && echo "## Licenca" >> README.md
git commit -am "wip: licenca"
git switch main && git merge docs
git branch --all > evidencias/git-branch.txt
git add evidencias/git-branch.txt && git commit -m "T10: integra branch docs na main"

# T11 gh auth + repo view
gh auth status 2> evidencias/gh-auth.txt
gh repo view --json name,owner,defaultBranchRef \
--jq '"repo=\(.owner.login)/\(.name) branch=\(.defaultBranchRef.name)"' > evidencias/gh-repo.txt
git add evidencias/gh-auth.txt evidencias/gh-repo.txt
git commit -m "T11: comprova auth e inspeciona o repo com gh"

# T12 README final -> "T12: monta o README final com sumario e ancoras"
# T13 release
git tag -a v1.0.0 -m "Lab 00 concluido" && git push origin v1.0.0
gh release create v1.0.0 --title "Lab 00 — v1.0.0" --notes "Concluido."
git commit --allow-empty -m "T13: publica release v1.0.0"

# T14 gh pr create ... > evidencias/gh-pr.txt -> "T14: ..."
# T15 gh issue create ... > evidencias/gh-issue.txt -> "T15: ..."
# T16 conflito.txt resolvido -> "T16: resolve conflito de merge"
# T17 gh api repos/{owner}/{repo}/releases/tags/v1.0.0 --jq '.tag_name' > evidencias/gh-api.txt

Checklist de entrega​

  • git config com nome e e-mail institucional corretos (T1).
  • Commits com prefixo Tn: na ordem T1…T17.
  • README.md com título, sumário de âncoras, listas, links, badge, bloco de código e tabela (T2–T8, T12).
  • .gitignore presente (T9).
  • Tudo enviado com git push; nada de push --force.
  • Release v1.0.0 publicado e visível em gh release list (T13).
  • Evidências presentes em evidencias/ para os passos de runtime.
Pontuação

Total: 100 pts (o autograder normaliza para 0–10). Base T1…T13 = 80 pts; Desafios T14…T17 = 20 pts.