https://github.com/carvalhoandre/dev-playbook
🔖 Playbook visual com boas práticas de Git, Angular e outras stacks — docs, diagramas, exemplos
https://github.com/carvalhoandre/dev-playbook
documentation
Last synced: 5 months ago
JSON representation
🔖 Playbook visual com boas práticas de Git, Angular e outras stacks — docs, diagramas, exemplos
- Host: GitHub
- URL: https://github.com/carvalhoandre/dev-playbook
- Owner: carvalhoandre
- License: mit
- Created: 2025-06-06T17:58:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-01T01:54:00.000Z (9 months ago)
- Last Synced: 2025-10-01T03:37:03.566Z (9 months ago)
- Topics: documentation
- Language: MDX
- Homepage:
- Size: 340 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📘 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**
```bash
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](LICENSE).
---
Feito com 💙 pela comunidade dev brasileira
Mantido por desenvolvedores para desenvolvedores