Guia de Contribuição para o climasus4r
Junte-se a Nós na Construção da Próxima Geração de Ferramentas Clima-Saúde
Dr. Max Anjos
02 April, 2026
Source:vignettes/contributing.Rmd
contributing.RmdBem-vindo(a) à comunidade climasus4r! — Este projeto é construído com o esforço coletivo de pesquisadores, desenvolvedores e entusiastas de dados. Toda contribuição, não importa o tamanho, é valiosa e bem-vinda. Este guia foi criado para ajudá-lo(a) a encontrar a melhor forma de participar.
Por Que Contribuir?
Contribuir para um projeto open-source como o climasus4r
é uma oportunidade de:
- Desenvolver Habilidades: Aprimore suas competências em R, Python, análise de dados, desenvolvimento de software e comunicação científica.
- Construir seu Portfólio: Contribuições no GitHub são uma expertise diferenciada para sua carreira acadêmica ou profissional.
- Fazer Networking: Conecte-se com uma rede de especialistas em clima, saúde e ciência de dados.
- Gerar Impacto: Ajude a construir uma ferramenta que fortalece a vigilância em saúde e subsidia políticas públicas no Brasil.
Código de Conduta: Todas as interações em nosso projeto seguem um Código de Conduta. Comprometemo-nos a manter um ambiente acolhedor, respeitoso e colaborativo para todos.
Funções a desempenhar
Nossa equipe é organizada em vários níveis de engajamento, desde liderança técnica até contribuições pontuais. Cada função dentro do fluxo de trabalho possui responsabilidades específicas, mas todos são essenciais para o sucesso do projeto climasus4r.
🚀 Perfil de Contribuição: Contribuidor • Documentação & Suporte • Assistente de Pesquisa • Desenvolvedor Assistente • Desenvolvedor Sênior • Engenheiro de Software • Consultor Científico • Coordenador
🎯 Núcleo de Liderança
Coordenador & Desenvolvedor Líder
LIDERANÇA
Responsabilidades: - Definir a visão estratégica e roadmap técnico do projeto - Arquitetar a estrutura geral do pacote e APIs - Coordenar releases e versionamento semântico - Revisar e aprovar Pull Requests críticos - Gerenciar relacionamentos com instituições parceiras - Orientar desenvolvedores sêniores e científicos
Requisitos:
Experiência avançada em desenvolvimento de pacotes R/Python, gestão de
projetos open-source, e liderança técnica. Domínio de Git, CI/CD, e
metodologias ágeis.
Como se tornar um:
Este papel é atribuído pelo mantenedor atual do projeto baseado em
contribuições consistentes, visão estratégica demonstrada e compromisso
de longo prazo.
💻 Equipe Técnica
Desenvolvedor R/Python Sênior
TÉCNICO AVANÇADO
| Responsabilidades | • Desenvolver funcionalidades complexas e módulos
core • Implementar otimizações de performance e escalabilidade • Criar testes automatizados robustos ( testthat,
pytest)• Revisar código de desenvolvedores juniores • Documentar arquitetura técnica e APIs internas |
| Stack Tecnológico | R avançado (data.table,
terra, sf, tidymodels), Python
(pandas, xarray, rasterio), Git
avançado, CI/CD (GitHub Actions), Docker |
| Requisitos | • 3+ anos de experiência com R ou Python • Experiência com geoprocessamento e análise espacial • Conhecimento de desenvolvimento de pacotes ( devtools,
setuptools)• Capacidade de mentoria técnica |
| Como Contribuir | 1. Procure Issues marcadas com complex ou
architecture2. Proponha melhorias de performance em funções existentes 3. Participe de decisões técnicas nas Discussions 4. Envie PRs com testes comprehensivos e documentação técnica |
Engenheiro de Software
INFRAESTRUTURA
| Responsabilidades | • Manter infraestrutura de CI/CD e automação • Gerenciar containers e ambientes de desenvolvimento • Implementar pipelines de dados e ETL • Garantir qualidade de código (linting, formatação) • Otimizar integração com sistemas externos (APIs, bancos de dados) |
| Stack Tecnológico | GitHub Actions, Docker, Linux, SQL/NoSQL, APIs REST, Cloud (AWS/GCP), Python/R para automação |
| Requisitos | • Experiência em DevOps e automação • Conhecimento de boas práticas de software engineering • Familiaridade com ambientes científicos de computação • Capacidade de documentar processos técnicos |
| Como Contribuir | 1. Melhore nossos workflows de GitHub Actions 2. Crie Dockerfiles para ambientes reprodutíveis 3. Implemente pipelines de validação de dados 4. Otimize a integração contínua e deploy automático |
Desenvolvedor R/Python Assistente
TÉCNICO JÚNIOR
| Responsabilidades | • Implementar funções auxiliares e utilitários • Corrigir bugs de complexidade média • Escrever testes unitários • Refatorar código para melhor legibilidade • Criar exemplos e vignettes |
| Stack Tecnológico | R intermediário (tidyverse,
sf básico), Python intermediário, Git básico,
RMarkdown/Quarto |
| Requisitos | • 1+ ano de experiência com R ou Python • Conhecimento de análise de dados • Vontade de aprender desenvolvimento de pacotes • Disponibilidade para receber feedback construtivo |
| Como Começar | 1. Busque Issues com labels
good first issue ou help wanted2. Faça fork do repositório e crie branches nomeadas ( feature/descricao-curta)3. Participe do programa de mentoria com desenvolvedores sêniores 4. Complete tarefas de refactoring e documentação |
🔬 Equipe Científica
Consultor Científico
VALIDAÇÃO CIENTÍFICA
| Responsabilidades | • Auditar validade estatística e epidemiológica dos
métodos • Validar interpretação de indicadores climáticos e de saúde • Revisar modelos estatísticos implementados • Sugerir novas análises e métricas relevantes • Co-autorar publicações e relatórios técnicos |
| Áreas de Expertise | Epidemiologia, Climatologia, Saúde Pública, Estatística, Biometeorologia, Saúde Ambiental |
| Requisitos | • Formação avançada (mestrado/doutorado) em área
correlata • Experiência com análise quantitativa de dados de saúde • Conhecimento de metodologias de pesquisa climática • Interesse em ciência aberta e reprodutibilidade |
| Como Participar | 1. Envie email para
climasus4r.dev@example.com com assunto “Consultoria
Científica”2. Anexe seu CV e descrição de expertise 3. Participe de reuniões mensais de validação científica 4. Revise Pull Requests que afetam métodos estatísticos |
Assistente de Pesquisa (IC, Mestrado, Doutorado, Pós-Doutorado)
PESQUISA APLICADA
| Responsabilidades | • Aplicar o pacote em projetos de pesquisa
acadêmica • Desenvolver estudos de caso com dados reais do SUS • Validar funcionalidades em cenários reais de pesquisa • Reportar bugs e sugerir melhorias baseadas em uso • Produzir material educacional e tutoriais |
| Oportunidades | • Iniciação Científica com bolsa • Dados para dissertação/tese • Co-autoria em artigos científicos • Networking com pesquisadores seniores |
| Requisitos | • Vínculo com instituição de pesquisa • Projeto relacionado a clima e saúde • Disposição para documentar o uso do pacote • Compromisso com ciência aberta |
| Como Participar | 1. Descreva seu projeto de pesquisa em uma
Discussion 2. Indique como o climasus4r se integra à sua pesquisa 3. Compartilhe resultados preliminares e feedback 4. Colabore na criação de vignettes baseadas em seu caso de uso |
🌟 Comunidade & Suporte
Documentação & Suporte
COMUNICAÇÃO
| Responsabilidades | • Manter documentação técnica atualizada (pkgdown,
Quarto) • Criar tutoriais, guias e materiais didáticos • Responder dúvidas em Issues e Discussions • Traduzir documentação (PT/EN/ES) • Gerenciar website e presença em redes sociais |
| Habilidades | Comunicação técnica, RMarkdown/Quarto, Git/GitHub, Design de materiais educacionais, Redes sociais acadêmicas |
| Requisitos | • Excelente capacidade de escrita técnica • Conhecimento básico de R (para testar exemplos) • Empatia para ajudar usuários iniciantes • Criatividade para comunicação científica |
| Como Contribuir | 1. Melhore a documentação de funções existentes 2. Crie tutoriais em vídeo ou blog posts 3. Responda dúvidas de novos usuários 4. Traduza conteúdo para outros idiomas 5. Proponha melhorias na UX do site e documentação |
Contribuidor do Projeto
COLABORADOR
| Atividades | • Reportar bugs e sugerir features via Issues • Testar novas versões e dar feedback • Compartilhar casos de uso e aplicações • Divulgar o pacote em eventos e redes sociais • Pequenas correções (typos, links quebrados) |
| Perfil | Entusiastas de dados, estudantes, profissionais de saúde, pesquisadores iniciantes — todos são bem-vindos! |
| Requisitos | • Conta no GitHub • Interesse em dados de clima e saúde • Vontade de participar da comunidade |
| Primeiros Passos | 1. ⭐ Star no repositório para
acompanhar atualizações 2. 📖 Leia a documentação e tente os exemplos 3. 🐛 Encontrou um problema? Abra uma Issue! 4. 💡 Tem uma ideia? Inicie uma Discussion 5. 🗣️ Conte para colegas sobre o projeto |
Como Escolher seu Perfil
Ainda não sabe por onde começar?
Responda
estas perguntas rápidas:
- Quero escrever código e tenho experiência: → Desenvolvedor Sênior ou Engenheiro de Software
- Quero escrever código mas estou aprendendo: → Desenvolvedor Assistente
- Sou pesquisador e quero usar o pacote: → Assistente de Pesquisa
- Sou especialista em métodos: → Consultor Científico
- Gosto de escrever e ajudar pessoas: → Documentação & Suporte
- Quero ajudar sem compromisso fixo: → Contribuidor do Projeto
Processo de Onboarding
- Leia o Código de Conduta — Todos os papéis exigem respeito mútuo
- Explore o Repositório — Familiarize-se com a estrutura e documentação existente
- Introduza-se — Na aba Discussions, apresente-se e mencione seu interesse
- Comece Pequeno — Escolha uma tarefa simples para primeiro contato
- Cresça Gradualmente — À medida que ganha confiança, assuma responsabilidades maiores
Reconhecimento:
Todos os contribuidores são
listados no site
climasus4r. Contribuições significativas são reconhecidas em
releases e publicações científicas.
Pronto para começar? 🚀
Acesse github.com/ByMaxAnjos/climasus4r
e faça parte da comunidade!