📘 dev-playbook

Guia definitivo com melhores práticas para desenvolvimento de software
Uma coleção de manuais práticos e visuais para criar, versionar e escalar projetos. Cada guia é autocontido e rico em diagramas, exemplos de código e dicas de produtividade.

🌟 Destaques

• 📊 Diagramas Interativos: Visualize fluxos e arquiteturas com Mermaid
• 💻 Exemplos Práticos: Código real e testado
• 🎯 Guias Específicos: Um manual completo para cada tecnologia
• 🔄 Sempre Atualizado: Mantido pela comunidade

📂 Organização do Projeto

dev-playbook/
├─ git/           # Guia completo de Git e versionamento
├─ angular/       # Arquitetura e boas práticas Angular
└─ shared-assets/ # Recursos compartilhados (diagramas, ícones)

📚 Guias Disponíveis

Tecnologia	O que você vai aprender
Git	• Fluxo de branches profissional • Padrões de commit • Resolução de conflitos • Workflow com Git Flow
Angular	• Arquitetura modular • Gerenciamento de estado • Performance e otimização • Pipeline CI/CD

🔜 Em Breve:

• Docker & DevOps
• API REST com Flask
• Automação com n8n

🚀 Como Começar

1. Clone o repositório

   git clone https://github.com/seu-usuario/dev-playbook.git

2. Escolha seu guia

   • Acesse a pasta do tema desejado
   • Comece pelo README.md principal
   • Siga os exemplos na ordem sugerida

💡 Como Contribuir

1. Prepare seu ambiente

   • Fork o repositório
   • Crie uma branch: feature/nova-funcionalidade

2. Siga os padrões

   • Use o template existente
   • Mantenha a formatação Markdown
   • Inclua diagramas Mermaid quando relevante

3. Envie sua contribuição

   • Faça commits semânticos
   • Abra um Pull Request
   • Aguarde a revisão

📅 Próximos Passos

• Expandir guia de Angular
• Adicionar seção de DevOps
• Incluir exemplos de microsserviços
• Criar templates para novos guias

📝 Licença

Este projeto está sob licença CC BY-NC-SA 4.0.

---

Feito com 💙 pela comunidade dev brasileira
Mantido por desenvolvedores para desenvolvedores