Módulo 4: GitHub como Portfólio de Solucionador Técnico

Ao final deste módulo, você será capaz de:

✅ Transformar GitHub de cemitério de código em portfólio vivo ✅ Estruturar repositórios que mostram valor, não só código ✅ Criar READMEs que vendem suas soluções ✅ Automatizar atualização do GitHub Profile ✅ Usar GitHub para virar referência técnica

---

Perfil Típico de Dev

npm install npm start `

GitHub como Portfólio de Solucionador

No meu time, deploy manual demorava 45 min e falhava 30% das vezes. Pessoas ficavam bloqueadas esperando DevOps fazer deploy.

Bot do Slack que faz deploy em 3 minutos com 1 comando. Qualquer dev pode fazer deploy sozinho, com rollback automático.

• ⏱️ 42 minutos economizados por deploy
• 📈120 deploys/mês → economiza 84 horas/mês do time
• 🎯Taxa de erro: 30% → 2%
• 😊 Satisfação do time: +40%

[continua...] `

---

1. Título que Vende o Valor

❌ Ruim: - scripts-python - automation-tools - bot-slack

✅ Bom: - deploy-bot → "Deploy automático via Slack" - onboarding-automation → "Onboarding de devs em 1 dia" - api-docs-chatbot → "ChatGPT que conhece nossa API"

2. README Estruturado

Template essencial:

# 🎯 [Nome do Projeto]

> [Pitch de 1 linha: problema + solução]

[3-5 linhas sobre o problema real que pessoas tinham]

[Como sua ferramenta resolve]

[Métricas concretas de uso/economia] - X pessoas usando - Y horas economizadas/mês - Z% de redução de erro

[Guia rápido de 3-5 passos]

[Tecnologias usadas + por que escolheu]

[Screenshots/GIF/vídeo mostrando funcionando]

[O que você aprendeu fazendo isso]

• [Artigo explicando] (se tiver)
• [Vídeo demo] (se tiver)
• [Deploy/uso] (se tiver)
• `

3. Estrutura de Pastas Clara

meu-projeto/
├── README.md (principal)
├── docs/
│   ├── SETUP.md (como rodar)
│   ├── ARCHITECTURE.md (como funciona)
│   └── USAGE.md (casos de uso)
├── examples/ (exemplos práticos)
├── src/ (código organizado)
└── .github/
    └── workflows/ (CI/CD se tiver)

4. Documentação Visual

!Arquitetura

Feito com Excalidraw `

---

README do Profile Dinâmico

Seu perfil github.com/seu-usuario pode ter README especial!

Exemplo básico:

# 👋 Oi, sou [Seu Nome]

Transformo problemas técnicos recorrentes em soluções automatizadas.

📈 Impacto

• 🕐 +200h/mês economizadas com automações
• 👥 50+ pessoas usando minhas ferramentas
• 📉 70% redução em tickets de suporte

🛠️ Stack Principal

!Python !Node.js !Docker !AWS

📚 Projetos em Destaque

#### 🤖 Deploy Bot Bot de Slack que automatiza deploys. 84h/mês economizadas.

#### 📖 API Docs Chatbot RAG chatbot com documentação da API. -60% tickets de suporte.

#### ⚡ Dev Onboarding Automação de setup de ambiente. 3 dias → 1 dia.

🌐 Onde Me Encontrar

  `

Componentes Dinâmicos

1. GitHub Stats (atualizados automaticamente)

![Stats](https://github-readme-stats.vercel.app/api?username=SEU-USERNAME&show_icons=true&theme=radical)

!Linguagens `

2. Atividade Recente (via GitHub Actions)

Crie .github/workflows/update-readme.yml:

name: Update README

on: schedule: - cron: '0 0 *' # Todo dia meia-noite workflow_dispatch:

jobs: update: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3

• name: Update README
• uses: jamesgeorge007/github-activity-readme@master
• env:
• GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
• with:
• COMMIT_MSG: 'Atualizar atividades recentes'
• MAX_LINES: 5
• `

No seu README.md:

📌 Atividade Recente

`

3. Blog Posts (se tiver blog RSS)

- name: Update Blog Posts
  uses: gautamkrishnar/blog-post-workflow@master
  with:
    feed_list: 'https://seu-blog.dev/rss.xml'

No README:

✍️ Posts Recentes

`

---

No nosso time de 30 devs, onboarding de novo desenvolvedor demorava 3-5 dias:

• ❌Instalar 15+ ferramentas manualmente
• ❌Configurar acessos em 10 sistemas diferentes
• ❌Depender de senior dev para explicar setup
• ❌Documentação desatualizada
• ⏱️ 40 horas de trabalho (dev novo + senior ajudando)

Script automatizado que faz todo setup via CLI:

./onboard.sh --name "Dev Novo" --team backend

# 1. Clone
git clone https://github.com/usuario/dev-onboarding-automation

# 2. Configure (só 1x) cp .env.example .env # Edite .env com tokens/APIs

# 3. Rode para novo dev ./onboard.sh --name "Maria Silva" --team frontend

# Aguarde 20 minutos e pronto! ✅ `

• Shell Script (orquestração)
• Python (APIs e validações)
• Slack API (notificações)
• GitHub API (repos e permissões)
• Jira API (criação de conta)

!Demo do onboarding

1. Idempotência é crítica: Script pode falhar no meio, precisa poder rodar de novo
2. Logging detalhado: Quando falha, precisa saber exatamente onde
3. Validação em camadas: Checar que tudo está ok antes de seguir
4. UX importa: Barra de progresso e mensagens claras fazem diferença

• 📝 Artigo: Como automatizamos onboarding
• 🎥 Vídeo demo (3 min)
• 📊 Slides da apresentação interna

PRs são bem-vindos! Veja CONTRIBUTING.md

---

Canal #help-tech recebia 50+ perguntas/dia: - "API retornando 502" - "Como fazer rollback?" - "Onde ver logs de produção?"

Bot que responde automaticamente perguntas comuns + busca em runbooks.

Exemplo de uso:

Dev: @troubleshoot API returning 502 in production

Bot: 🔍 Checando status da API...

✅ Encontrei isso no runbook:

502 Bad Gateway geralmente significa: 1. Backend está down 2. Nginx não consegue conectar

📊 Status atual: API está UP, 3/3 pods healthy 📈 Últimos 5min: 0 erros 502

Resolveu? 👍 Ainda com problema? 👎 `

[continua...] `

---

1. Awesome List Pessoal

# Awesome DevOps Tools 🚀

> Ferramentas e recursos que uso diariamente (testadas em produção)

[Deploy Bot](https://github.com/usuario/deploy-bot) ⭐ Meu projeto

Deploy via Slack. Economiza 84h/mês.

[Octopus Deploy](https://octopus.com/)

Deploy enterprise. Uso para Windows/.NET. Prós: UI ótima, rollback fácil Contras: Caro ($$$)

[continua organizando por categoria...] `

2. TIL (Today I Learned)

# TIL - Today I Learned

Aprendizados diários de DevOps/Python/Cloud

Descobri que ordem dos comandos no Dockerfile afeta cache:

❌ Ruim (cache quebra sempre): `dockerfile COPY . /app RUN pip install -r requirements.txt `

✅ Bom (cache reusa): `dockerfile COPY requirements.txt /app/ RUN pip install -r requirements.txt COPY . /app `

Tags: #docker #performance

---

[continua...] `

3. Dotfiles

Suas configurações de terminal/editor organizadas.

# My Dotfiles

Configurações de desenvolvimento otimizadas para [sua stack]

• 🚀Aliases que economizam 30 min/dia
• 🎨 Tema Dracula customizado
• ⚡Vim configs para Python/JS
• 🔧Git configs produtivas

git clone https://github.com/usuario/dotfiles
cd dotfiles
./install.sh
```

---

Semana Típica (2h total)

Crescimento Orgânico

Mês 1-2: Fundação - ✅ GitHub Profile README profissional - ✅ 3-5 repos de soluções documentados - ✅ TIL com 10-15 entradas - ✅ 1 awesome list

Mês 3-4: Consistência - ✅ 1 novo projeto/mês - ✅ TIL diário (3-5x/semana) - ✅ Melhorar SEO dos READMEs - ✅ Primeiras stars de estranhos

Mês 5-6: Reconhecimento - ✅ 100+ stars total - ✅ Primeiros forks - ✅ Issues de pessoas usando - ✅ Menções em blogs/Twitter

Métricas que Importam

---

1. GitHub CLI (gh)

# Instalar
brew install gh  # Mac
sudo apt install gh  # Linux

# Criar repo rapidinho gh repo create meu-projeto --public --clone

# Abrir issues gh issue create --title "Feature X" --body "Descrição..."

# Ver PRs gh pr list

# Checar stats gh repo view --web `

2. Badges Automáticos

Adicione em READMEs:

![GitHub stars](https://img.shields.io/github/stars/usuario/repo?style=social)
![GitHub forks](https://img.shields.io/github/forks/usuario/repo?style=social)
![GitHub issues](https://img.shields.io/github/issues/usuario/repo)
![Last commit](https://img.shields.io/github/last-commit/usuario/repo)

!Python !License `

Gere em: shields.io

3. Releases Automáticos

.github/workflows/release.yml:

name: Release

on: push: tags: - 'v*'

jobs: release: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3

• name: Create Release
• uses: softprops/action-gh-release@v1
• with:
• generate_release_notes: true
• env:
• GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
• `

Usar: `bash git tag v1.0.0 git push origin v1.0.0 # Release criado automaticamente! `

4. README Generator

Use IA para gerar primeiro draft:

Prompt para ChatGPT:

Crie um README.md profissional para meu projeto:

Use template com: - Título chamativo - Seção "O Problema" com dores específicas - Seção "A Solução" com benefícios - Seção "Impacto Real" com métricas - Como usar (passos) - Stack técnica - Demo (placeholder para GIF) - Badges `

Depois você refina com detalhes reais!

---

Profile README

• [ ] Repositório seu-usuario/seu-usuario criado
• [ ] README.md com:
• [ ] Introdução clara (quem você é, o que faz)
• [ ] Problemas que resolve
• [ ] 3-5 projetos em destaque (com métricas)
• [ ] Stack técnica com badges
• [ ] Links (LinkedIn, Blog, etc)
• [ ] GitHub stats (opcional)
• [ ] Foto de perfil profissional
• [ ] Bio clara (1 linha de impacto)

Repositórios

Extras (diferencial)

• [ ] TIL repository (aprendizados)
• [ ] Awesome list da sua área
• [ ] Dotfiles publicados
• [ ] GitHub Actions em pelo menos 1 repo
• [ ] Contribuiu em 3+ repos open source
• [ ] Pinned repos organizados (6 melhores)

---

Desafio: Transformar 1 Projeto

Critérios: - Resolve problema real - Você ou outros usam - Tem código minimamente organizado

Use o template: 1. Problema (dores específicas) 2. Solução (como resolve) 3. Impacto (métricas reais ou estimadas) 4. Como usar (3-5 passos) 5. Stack (ferramentas + por quê) 6. Demo (screenshot mínimo)

• Mover código para /src
• Criar /docs se necessário
• Adicionar LICENSE
• Criar .gitignore
• Adicionar topics/tags

• Pin no seu perfil
• Compartilhar no LinkedIn:
• `
• Resolvi o problema de [X] criando [Y].

Resultado: [métrica de impacto]

Código open source: [link] `

---

---

1. Qualidade > Quantidade

• ✅3 repos impecáveis > 30 repos abandonados
• ✅Melhor ter 5 projetos com métricas reais
• ❌Não publique tudo (só o que tem valor)

2. Pense em SEO

READMEs são indexados pelo Google!

Python-based Slack bot for automated deployments... `

Vai aparecer em: - "slack deploy bot" - "automated deployment slack" - "github actions slack integration"

3. Mostre, Não Conte

❌ "Ferramenta muito rápida" ✅ "Deploy em 3 min (antes: 45 min)"

❌ "Reduz erros" ✅ "Taxa de erro: 30% → 2%"

❌ "Muito útil" ✅ "50 pessoas usando diariamente"

4. Mantenha Vivo

Repo abandonado = red flag

5. Contribua em Projetos Famosos

• Escolha projeto que você USA
• Procure issues marcadas "good first issue"
• Melhore documentação (sempre aceito)
• Reporte bugs com reprodução clara

---

Nível 1: Fundação ✅ - GitHub Profile profissional - 3 repos de soluções documentados - READMEs com problema/solução/impacto

Nível 2: Consistência - TIL com commits regulares - Awesome list curada - 1 projeto novo/mês - Contribuições em open source

Nível 3: Reconhecimento - 100+ stars total - Issues/PRs de estranhos - Projeto mencionado em blog/talk - GitHub como portfólio em entrevistas

Nível 4: Autoridade - 500+ stars - Projeto usado em produção (outras empresas) - Convites para manter projetos conhecidos - GitHub Sponsors habilitado

---

O que você aprendeu:

✅ GitHub é vitrine, não cemitério - Mostre VALOR, não só código - Conte histórias de problemas resolvidos - Métricas de impacto > descrições técnicas

✅ README é seu pitch - Problema → Solução → Impacto - Screenshots/demos vendem - SEO importa

✅ Profile dinâmico - README do perfil automatizado - Pinned repos estratégicos - Stats e atividade visíveis

✅ Consistência > perfeição - Melhor 3 repos ótimos que 30 medíocres - Mantenha vivo ou archive - Contribua regularmente

---

---