> For the complete documentation index, see [llms.txt](https://favelaware.gitbook.io/favelaware/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://favelaware.gitbook.io/favelaware/3-git-e-github/projeto.md).

# Projeto

### 📘 **Projeto Final: "Diário de Versionamento em Equipe"**

#### 🎯 Objetivo:

Criar um repositório colaborativo no GitHub simulando um projeto real de equipe.\
Os alunos devem usar **todas as etapas de um fluxo de trabalho com Git e GitHub**, com foco em controle de versão, organização e colaboração.

***

### 📦 Nome do Projeto (sugestão):

**`diario-dev-equipe-X`**\
(Substituir "X" pelo nome do grupo)

***

### 👥 Formação:

* Grupos de 3 a 5 alunos
* Cada aluno é responsável por **uma branch e um conteúdo diferente**

***

### 📂 Estrutura esperada do repositório

```
diario-dev-equipe-X/
├─ README.md
├─ equipe/
│  ├─ aluno1.txt
│  ├─ aluno2.txt
│  ├─ ...
├─ ideias/
│  ├─ ferramenta-favorita.txt
│  ├─ aprendizado-da-semana.txt
├─ imagens/
│  ├─ print-log-git.png
│  ├─ estrutura-branches.png
```

***

### 📋 O que cada aluno deve fazer

#### 1. Criar sua própria branch:

```bash
git checkout -b aluno-seunome
```

#### 2. Adicionar:

* Um arquivo com seu nome dentro de `equipe/`
* Uma descrição com:
  * Quem é você
  * O que achou do Git
  * Qual comando mais gostou
  * Dificuldade que teve

#### 3. Commitar:

```bash
git add .
git commit -m "Adiciona depoimento do aluno [nome]"
```

#### 4. Push para o GitHub:

```bash
git push origin aluno-seunome
```

#### 5. Abrir um **Pull Request**

#### 6. Trocar revisão com outro colega

***

### 📑 Entregas obrigatórias do grupo:

| Item                                        | Como entregar                                 |
| ------------------------------------------- | --------------------------------------------- |
| `README.md` explicando o projeto e a equipe | Com Markdown, nomes, emojis, e objetivos      |
| Pelo menos 1 arquivo por aluno              | Na pasta `equipe/`                            |
| Pelo menos 2 Pull Requests por aluno        | Um feito por ele, um revisado de outro colega |
| Imagem de `git log --oneline`               | Print salvo na pasta `imagens/`               |
| Merge final feito pelo responsável          | Todos os arquivos devem estar na `main`       |

***

### 🧠 O que será avaliado

| Critério                        | Peso |
| ------------------------------- | ---- |
| Uso correto dos comandos Git    | 25%  |
| Organização das branches        | 20%  |
| Clareza dos commits             | 15%  |
| Colaboração (PRs e revisões)    | 20%  |
| Qualidade do README e estrutura | 20%  |

***

### 🏁 Dica bônus (valendo ponto extra)

* Criar uma branch `hotfix/ajuste-final` e fazer uma correção simples em algo do grupo
* Usar `.gitignore` para ignorar arquivos desnecessários (ex: `.vscode`, `*.log`)
* Adicionar no `README.md` uma linha explicando como clonar o projeto


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://favelaware.gitbook.io/favelaware/3-git-e-github/projeto.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.