Formato de Entrega

Toda entrega desta disciplina — exercícios e projetos — é feita como um site no GitHub Pages apoiado em um repositório público. Um repositório, para o semestre inteiro, que cresce uma pasta por vez.

Esse acúmulo é o ponto. No fim do semestre você não tem quatro trabalhos soltos; você tem um portfólio para mostrar a alguém.

Cadastre seu repositório uma vez

Envie o link por este formulário — uma única vez, no começo do semestre. Não há nada a reenviar a cada prazo: o repositório é o mesmo o semestre todo, e quem decide o prazo são os seus commits. Preencha de novo apenas se mudar o repositório de lugar. Uma segunda resposta com o mesmo e-mail substitui a primeira.

O repositório

Faça um fork do template da disciplina — MkDocs + Material com um workflow do GitHub Actions que publica a cada push, a mesma pilha em que este site roda. Mantenha o repositório público, para que ele possa ser lido na correção e para que sirva de portfólio.

Estrutura obrigatória

O nome da pasta é o contrato. É por ele que cada entrega é localizada:

docs/
  index.md                     # sua página inicial — quem é você, o que tem aqui
  exercises/
    data/index.md
    perceptron/
      index.md                 # o relatório
      code/                    # os fontes que você realmente rodou
      figures/                 # as figuras que o relatório mostra
    mlp/index.md
    vae/index.md
  projects/
mkdocs.yml
requirements.txt               # para outra pessoa conseguir rodar seu código

Os slugs são fixos — data, perceptron, mlp, vae — e são os mesmos deste site.

Front matter obrigatório

No topo de cada relatório:

---
exercise: perceptron
ai_use: "Claude no código do gráfico da Figura 3; a análise é minha."
---

ai_use é obrigatório e pode ser "none". Colaboração com IA é permitida; o que dá problema é não declarar.

Organização obrigatória

Seus títulos espelham o enunciado, na mesma ordem:

## Exercício 1
### A — Gere os dados
### B — Implemente o perceptron
...
## Resumo dos resultados

Isso não é burocracia. Cada critério de avaliação está amarrado a uma letra de item, então um relatório com a forma do enunciado é lido contra o critério certo. Um relatório que espalha os itens obriga o corretor a caçar — e corretor que caça, acha menos.

A última seção é sempre a tabela de Resumo dos resultados da página do exercício, com as linhas na ordem e a coluna # preservada. Preencha todas: linha em branco é lida como "não fez", mesmo que o número esteja perdido em algum lugar do seu texto.

Código mora em arquivo

Todo script vai para code/, e o relatório o inclui em vez de apenas colar:

``` python
\--8<-- "docs/exercises/perceptron/code/perceptron.py"
```

Código que só existe como texto na página não pode ser executado, e conseguir reexecutá-lo é critério de nota. Vale o mesmo para as figuras: ![Figura 1](figures/fig1.png), versionada no repositório — figura apenas mencionada não foi entregue.

Prazos

O prazo é o horário do seu último commit na pasta daquele exercício. Não é o formulário, nem o push para o Pages — é o commit.

Vá commitando ao longo do caminho. Um único commit às 23:58 do dia da entrega é perfeitamente válido e será corrigido normalmente, mas não deixa nenhum rastro de como o trabalho aconteceu — e é exatamente a entrega que uma prova oral vai pedir que você explique.

Antes de entregar

O repositório está público e o site do Pages realmente compila
docs/exercises/<slug>/index.md existe, com o slug exato
Front matter com exercise: e ai_use:
Os títulos espelham o enunciado: Exercício N, depois A, B, C, D
Toda figura pedida está versionada e exibida, numerada
Todo script é um arquivo em code/ e roda a partir de um clone limpo
A tabela de Resumo dos resultados está preenchida, linha por linha
Cada pergunta de análise foi respondida com o número que a sustenta
Seu último commit é anterior ao prazo

O que é lido

O site publicado é o seu portfólio. O repositório é o que é corrigido: o markdown, o código como arquivo e o histórico do git. Então um site bonito cujo repositório não tem o código não é uma entrega completa — e um repositório com tudo no lugar, cujo CI por acaso quebrou, ainda é.