Facilitando Acolhimento e Crescimento de Contribuidores
Versão: 1.0 Data: 2025-01-20
O sistema de mentoria do Arah é orgânico, voluntário e horizontal. Não há hierarquias rígidas - apenas pessoas que oferecem ajuda e pessoas que buscam orientação.
Objetivo: Facilitar o acolhimento de novos contribuidores e o crescimento orgânico da comunidade, mantendo consciência elevada e respeito aos saberes diversos.
🌱 Princípios
Orgânico
Ninguém é obrigado - mentoria é voluntária
Cresce naturalmente - conforme necessidade
Sem burocracia - simples e direto
Horizontal
Sem hierarquias - mentor e mentorado são pares
Aprendizado mútuo - todos têm algo a ensinar
Respeito mútuo - valoriza diferentes saberes
Consciente
Respeita ritmo - cada um tem seu tempo
Valoriza inteligência - diferentes tipos de expertise
Acolhe diversidade - backgrounds diversos são bem-vindos
📋 Para Quem Busca Mentoria
Como Pedir Ajuda
Vá para #geral ou #mentoria (quando configurado)
Use este template:
📚 **Buscando Orientação**
Olá! Sou [seu nome], [background breve - ex: "matemático", "estudante", etc.].
Estou começando a contribuir como [desenvolvedor/analista funcional/comunidade].
Precisaria de ajuda com [tópico específico - ex: "como configurar ambiente", "como documentar proposta funcional"].
Alguém poderia me orientar? Obrigado! 🙏
Aguarde - alguém vai se oferecer para ajudar
Opção 2: GitHub
Crie Issue com label question ou mentoria
Descreva o que precisa
Aguarde resposta da comunidade
Opção 3: Issue Específica
Se sua dúvida é sobre Issue específica, comente nela
Mentores que trabalharam nessa área podem responder
Um mentor pode:
✅ Orientar sobre processos do projeto
✅ Ajudar a entender código/documentação
✅ Revisar propostas antes de criar Issue/PR
✅ Responder dúvidas técnicas ou funcionais
✅ Conectar você com pessoas certas
Um mentor NÃO é obrigado a:
❌ Fazer o trabalho por você
❌ Estar sempre disponível 24/7
❌ Revisar tudo que você faz
❌ Ser expert em tudo
Respeite o tempo do mentor - eles também são voluntários.
Checkpoints Sugeridos
Não é obrigatório, mas pode ser útil:
Após 30 Dias
Como está sendo sua experiência?
Conseguiu fazer primeira contribuição?
Precisa de ajuda com algo específico?
Após 60 Dias
Está confortável com processos?
Quer contribuir mais ativamente?
Tem interesse em ser mentor também?
Após 90 Dias
Como foi seu crescimento?
O que funcionou bem?
O que poderia melhorar?
Estes checkpoints são opcionais - faça se fizer sentido para você.
👨🏫 Para Quem Quer Ser Mentor
Como Se Oferecer
Vá para #geral ou #mentoria
Use este template:
🤝 **Oferecendo Mentoria**
Olá! Posso ajudar iniciantes em [área específica - ex: "setup do Cursor", "análise funcional", "testes"].
Se alguém precisar de orientação nessas áreas, pode me chamar!
Disponibilidade: [ex: "finais de semana", "durante a semana", etc.] (opcional)
Aguarde - pessoas podem te procurar
Opção 2: GitHub
Atualize seu perfil ou bio no GitHub mencionando disponibilidade
Responda Issues de iniciantes
Revisa PRs de iniciantes com cuidado e gentileza
Como Ser um Bom Mentor
1. Seja Acolhedor
Lembre-se de quando você começou
Use linguagem clara e simples
Evite jargão quando possível
Seja paciente
2. Seja Humilde
Você não sabe tudo (e tudo bem!)
Aprenda com seus mentorados também
Admita quando não sabe algo
Conecte com outras pessoas se necessário
3. Seja Respeitoso
Valorize diferentes tipos de inteligência
Respeite ritmo de aprendizado
Não julgue - oriente
Celebre pequenas conquistas
4. Seja Consciente
Pense no impacto de sua orientação
Mantenha comunicação elevada
Honre saberes diversos
Fortaleça autonomia
Desenvolvimento:
Setup do ambiente (Git, .NET, Cursor)
Entender código do projeto
Escrever testes
Criar Pull Requests
Análise Funcional:
Observar território
Documentar necessidades
Criar propostas funcionais
Validar com comunidade
Processos:
Como funciona o projeto
Como contribuir
Como navegar documentação
Como comunicar no Discord/GitHub
Outras:
Qualquer área onde você tenha experiência e possa ajudar
✅ Analista Ativo: 3+ propostas, validações com comunidade
✅ Validador: Pode validar propostas de outros analistas
🔄 Fluxo de Mentoria
Fluxo Simples
1. Pessoa busca ajuda (Discord/GitHub)
↓
2. Mentor se oferece ou é mencionado
↓
3. Conversa inicial (entender necessidade)
↓
4. Orientação/ajuda fornecida
↓
5. Acompanhamento (se necessário)
↓
6. Mentorado cresce e pode virar mentor
Cenário: João quer fazer primeira contribuição mas não sabe por onde começar
João posta no Discord: "Não sei por onde começar"
Maria se oferece: "Posso te ajudar! Que tipo de contribuição te interessa?"
Conversam: Maria ajuda João a escolher Issue adequada
Orientação: Maria explica processo de PR, revisa código de João
PR mergeado: João faz primeira contribuição
Celebração: Comunidade celebra conquista de João
Crescimento: João agora pode ajudar outros iniciantes
💬 Boas Práticas de Comunicação
Seja claro:
Explique sua dúvida de forma específica
Dê contexto (o que você já tentou, o que sabe)
Mostre código/erro se for técnica
Exemplo bom:
"Preciso de ajuda para configurar o Cursor. Instalei o .NET 8.0 e o Git, mas quando abro o projeto no Cursor não consigo fazer build. Erro: [erro específico]"
Exemplo a evitar:
"Nada funciona, ajuda!"
Seja gentil:
Use linguagem acolhedora
Celebre pequenos progressos
Não assuma que pessoa sabe algo
Ofereça recursos adicionais
Exemplo bom:
"Ótima pergunta! Vou te ajudar. Primeiro, vamos verificar se o .NET está instalado corretamente. Execute dotnet --version e me diga o que aparece."