project_guidelines.md

Diretrizes de Projetos do Nucleo42 Hub

Este documento orienta a criação e gestão de projetos no Nucleo42 Hub.

1. Proposta e Aprovação de Projeto

• Use o template "Solicitar Novo Projeto" nas issues do GitHub
• Forneça uma descrição clara do projeto, objetivos e tecnologias
• Administradores revisarão as propostas na ordem de chegada
• Após aprovação, administradores criarão:
  • Repositório(s) necessário(s)
  • Times no GitHub
  • Permissões adequadas para o projeto

2. Estrutura do Projeto

• Mantenha um README.md atualizado com:
  • Descrição do projeto
  • Instruções de instalação/configuração
  • Guia de contribuição
• Considere incluir um CONTRIBUTING.md com diretrizes específicas

3. Práticas Recomendadas (não obrigatórias)

• Gerenciamento de branches (ex: Git Flow)
• Commits claros e descritivos
• Pull Requests para alterações significativas
• Revisão de código entre membros da equipe
• Boas práticas de codificação e documentação

4. Colaboração

• Use o Discord para comunicação diária
• Use issues do GitHub para discussões relacionadas ao projeto
• Realize reuniões regulares de acompanhamento
• Resolva conflitos de forma construtiva
• Busque mediação dos administradores se necessário

5. Qualidade e Manutenção (sugestões)

• Implementação de testes
• Configuração de CI/CD
• Atualização regular de dependências e documentação

6. Conclusão do Projeto

• Prepare uma release final ao atingir os objetivos
• Documente resultados e aprendizados
• Defina um plano para manutenção ou arquivamento

Estas diretrizes são flexíveis e podem ser adaptadas às necessidades específicas de cada projeto. A responsabilidade principal pelo desenvolvimento e manutenção recai sobre o líder do projeto e sua equipe.