Pular para conteúdo

Aula 15 - Projeto Integrador Final 🚀

Objetivo

Objetivo: Consolidar todos os conhecimentos técnicos e visuais adquiridos ao longo do curso (Módulos 1 a 4) através da criação de um Repositório de Documentação Profissional completo, pronto para ser publicado no GitHub Pages.

1. O Grande Desafio 🏆

Chegou a hora de unir todas as peças do quebra-cabeça. Não aprenderemos comandos novos hoje; em vez disso, vamos orquestrar tudo o que já sabemos para criar um produto final que servirá como seu portfólio de Documentação Técnica.

2. Requisitos Mandatórios do Projeto 🧱

Seu repositório final deve conter:

  • Módulo 1: Estrutura organizada de pastas, títulos H1/H2 e listas.
  • Módulo 2: Tabelas técnicas de requisitos e checklists de progresso.
  • Módulo 3: Pelo menos dois diagramas Mermaid (Fluxo e Sequência) e uma fórmula MathJax.
  • Módulo 4: Um deck de slides (.md) funcional e uma simulação termynal.

3. Checklist de Excelência ✅

  • Todos os links internos estão funcionando?
  • As imagens possuem texto alternativo (alt text)?
  • O arquivo index.md (página inicial) é convidativo?
  • O código possui destaque de sintaxe correto?
  • O repositório possui uma licença aberta (MIT, por exemplo)?

4. Estrutura do Ecossistema (Mermaid) 🧜‍♀️

mermaid graph TD REPOS[Seu Repositório] --> DOCS[Pasta docs/] DOCS --> INDEX[index.md - Landing Page] DOCS --> TECH[tech_specs.md - Tabelas/Fórmulas] DOCS --> DIAG[diagrams.md - Mermaid] DOCS --> SLIDE[slides.md - Reveal.js] REPOS --> MKD[mkdocs.yml - Configuraçao]

5. Simulação de Entrega Profissional 🐚

$ git add .
$ git commit -m "feat: finaliza projeto integrador v1.0"
$ git push origin main
$ mkdocs gh-deploy
$ echo "Projeto no ar!"

6. Mini-Projeto: O Integrador 🎨

Esta aula É o mini-projeto final. Utilize o que você desenvolveu nas aulas 08 e 12 como base para expandir o seu repositório. O objetivo é que qualquer pessoa que veja o seu site entenda imediatamente que você domina o Markdown Moderno.

7. Exercícios de Auto-Avaliação 🧠

  1. Qual foi o recurso de Markdown que você teve mais facilidade em aprender?
  2. Qual recurso (Mermaid, MathJax, Reveal.js) você considera o mais poderoso para o seu futuro profissional?
  3. Se você tivesse que explicar para um colega por que usar MkDocs em vez de um documento Word, o que você diria?

Próxima Aula: Finalização e Apresentação! 🎓