Guía de Contribución para climasus4r

<div class=“callout-box”> ¡Bienvenido(a) a la comunidad climasus4r! — Este proyecto se construye con el esfuerzo colectivo de investigadores, desarrolladores y entusiastas de los datos. Toda contribución, sin importar su tamaño, es valiosa y bienvenida. Esta guía ha sido creada para ayudarte a encontrar la mejor manera de participar. </div>

¿Por Qué Contribuir?

Contribuir a un proyecto de código abierto como climasus4r es una oportunidad para:

Desarrollar Habilidades: Mejora tus competencias en R, Python, análisis de datos, desarrollo de software y comunicación científica.
Construir tu Portafolio: Las contribuciones en GitHub son una experiencia distintiva para tu carrera académica o profesional.
Hacer Networking: Conéctate con una red de expertos en clima, salud y ciencia de datos.
Generar Impacto: Ayuda a construir una herramienta que fortalece la vigilancia en salud y apoya las políticas públicas en Brasil.

<div class=“callout callout-tip”> Código de Conducta: Todas las interacciones en nuestro proyecto siguen un Código de Conducta. Nos comprometemos a mantener un ambiente acogedor, respetuoso y colaborativo para todos. </div>

Roles a Desempeñar

Nuestro equipo está organizado en varios niveles de compromiso, desde liderazgo técnico hasta contribuciones puntuales. Cada rol dentro del flujo de trabajo tiene responsabilidades específicas, pero todos son esenciales para el éxito del proyecto climasus4r.

<div class=“pathway-box” style=“line-height: 2;”> <strong style=“display: block; margin-bottom: 8px;”>🚀 Perfil de Contribución:</strong> <span class=“badge”>Contribuidor</span> • <span class=“badge”>Documentación y Soporte</span> • <span class=“badge”>Asistente de Investigación</span> • <span class=“badge”>Desarrollador Asistente</span> • <span class=“badge”>Desarrollador Senior</span> • <span class=“badge”>Ingeniero de Software</span> • <span class=“badge”>Consultor Científico</span> • <span class=“badge”>Coordinador</span> </div>

🎯 Núcleo de Liderazgo

Coordinador y Desarrollador Principal

<div class=“role-card”> <span class=“badge badge-core”>LIDERAZGO</span>

Responsabilidades:

Definir la visión estratégica y la hoja de ruta (roadmap) técnica del proyecto
Diseñar la arquitectura general del paquete y las APIs
Coordinar lanzamientos y el versionado semántico
Revisar y aprobar Pull Requests críticos
Gestionar relaciones con instituciones asociadas
Guiar a los desarrolladores senior y científicos

Requisitos: Experiencia avanzada en el desarrollo de paquetes R/Python, gestión de proyectos de código abierto y liderazgo técnico. Dominio de Git, CI/CD y metodologías ágiles.

Cómo convertirse en uno: Este rol es asignado por el actual mantenedor del proyecto basándose en contribuciones consistentes, visión estratégica demostrada y compromiso a largo plazo.

</div>

💻 Equipo Técnico

Desarrollador R/Python Senior

<div class=“role-card”> <span class=“badge badge-tech”>TÉCNICO AVANZADO</span>

Responsabilidades	• Desarrollar funcionalidades complejas y módulos core • Implementar optimizaciones de rendimiento y escalabilidad • Crear pruebas automatizadas robustas (`testthat`, `pytest`) • Revisar el código de desarrolladores junior • Documentar la arquitectura técnica y APIs internas
Stack Tecnológico	R avanzado (`data.table`, `terra`, `sf`, `tidymodels`), Python (`pandas`, `xarray`, `rasterio`), Git avanzado, CI/CD (GitHub Actions), Docker
Requisitos	• 3+ años de experiencia con R o Python • Experiencia con geoprocesamiento y análisis espacial • Conocimiento en desarrollo de paquetes (`devtools`, `setuptools`) • Capacidad de mentoría técnica
Cómo Contribuir	1. Busca Issues etiquetados como `complex` o `architecture` 2. Propón mejoras de rendimiento en funciones existentes 3. Participa en decisiones técnicas en las Discussions 4. Envía PRs con pruebas exhaustivas y documentación técnica

</div>

Ingeniero de Software

<div class=“role-card”> <span class=“badge badge-tech”>INFRAESTRUCTURA</span>

Responsabilidades	• Mantener la infraestructura de CI/CD y automatización • Gestionar contenedores y entornos de desarrollo • Implementar pipelines de datos y ETL • Garantizar la calidad del código (linting, formato) • Optimizar la integración con sistemas externos (APIs, bases de datos)
Stack Tecnológico	GitHub Actions, Docker, Linux, SQL/NoSQL, APIs REST, Cloud (AWS/GCP), Python/R para automatización
Requisitos	• Experiencia en DevOps y automatización • Conocimiento de buenas prácticas de ingeniería de software • Familiaridad con entornos de computación científica • Capacidad para documentar procesos técnicos
Cómo Contribuir	1. Mejora nuestros flujos de trabajo de GitHub Actions 2. Crea Dockerfiles para entornos reproducibles 3. Implementa pipelines de validación de datos 4. Optimiza la integración continua y el despliegue automático

</div>

Desarrollador R/Python Asistente

<div class=“role-card”> <span class=“badge badge-tech”>TÉCNICO JUNIOR</span>

Responsabilidades	• Implementar funciones auxiliares y utilidades • Corregir errores (bugs) de complejidad media • Escribir pruebas unitarias • Refactorizar código para mejorar la legibilidad • Crear ejemplos y viñetas (vignettes)
Stack Tecnológico	R intermedio (`tidyverse`, `sf` básico), Python intermedio, Git básico, RMarkdown/Quarto
Requisitos	• 1+ año de experiencia con R o Python • Conocimiento de análisis de datos • Deseo de aprender desarrollo de paquetes • Disposición para recibir feedback constructivo
Cómo Empezar	1. Busca Issues con etiquetas `good first issue` o `help wanted` 2. Haz un fork del repositorio y crea ramas nombradas (`feature/descripcion-corta`) 3. Participa en el programa de mentoría con desarrolladores senior 4. Completa tareas de refactorización y documentación

</div>

🔬 Equipo Científico

Consultor Científico

<div class=“role-card”> <span class=“badge badge-science”>VALIDACIÓN CIENTÍFICA</span>

Responsabilidades	• Auditar la validez estadística y epidemiológica de los métodos • Validar la interpretación de indicadores climáticos y de salud • Revisar modelos estadísticos implementados • Sugerir nuevos análisis y métricas relevantes • Co-escribir publicaciones y reportes técnicos
Áreas de Especialización	Epidemiología, Climatología, Salud Pública, Estadística, Biometeorología, Salud Ambiental
Requisitos	• Formación avanzada (maestría/doctorado) en área afín • Experiencia con análisis cuantitativo de datos de salud • Conocimiento de metodologías de investigación climática • Interés en ciencia abierta y reproducibilidad
Cómo Participar	1. Envía un correo a `climasus4r.dev@example.com` con el asunto “Consultoría Científica” 2. Adjunta tu CV y descripción de experiencia 3. Participa en reuniones mensuales de validación científica 4. Revisa Pull Requests que afecten métodos estadísticos

</div>

Asistente de Investigación (Licenciatura, Maestría, Doctorado, Posdoctorado)

<div class=“role-card”> <span class=“badge badge-science”>INVESTIGACIÓN APLICADA</span>

Responsabilidades	• Aplicar el paquete en proyectos de investigación académica • Desarrollar estudios de caso con datos reales del SUS • Validar funcionalidades en escenarios reales de investigación • Reportar errores y sugerir mejoras basadas en el uso • Producir material educativo y tutoriales
Oportunidades	• Iniciación Científica con beca • Datos para tesis/disertación • Co-autoría en artículos científicos • Networking con investigadores senior
Requisitos	• Vínculo con una institución de investigación • Proyecto relacionado con clima y salud • Disposición para documentar el uso del paquete • Compromiso con la ciencia abierta
Cómo Participar	1. Describe tu proyecto de investigación en una Discussion 2. Indica cómo climasus4r se integra a tu investigación 3. Comparte resultados preliminares y retroalimentación 4. Colabora en la creación de viñetas basadas en tu caso de uso

</div>

🌟 Comunidad y Soporte

Documentación y Soporte

<div class=“role-card”> <span class=“badge badge-community”>COMUNICACIÓN</span>

Responsabilidades	• Mantener actualizada la documentación técnica (pkgdown, Quarto) • Crear tutoriales, guías y materiales didácticos • Responder dudas en Issues y Discussions • Traducir documentación (PT/EN/ES) • Gestionar el sitio web y presencia en redes sociales
Habilidades	Comunicación técnica, RMarkdown/Quarto, Git/GitHub, Diseño de materiales educativos, Redes sociales académicas
Requisitos	• Excelente capacidad de escritura técnica • Conocimiento básico de R (para probar ejemplos) • Empatía para ayudar a usuarios principiantes • Creatividad para la comunicación científica
Cómo Contribuir	1. Mejora la documentación de funciones existentes 2. Crea video tutoriales o publicaciones de blog 3. Responde preguntas de nuevos usuarios 4. Traduce contenido a otros idiomas 5. Propón mejoras en la UX del sitio y la documentación

</div>

Contribuidor del Proyecto

<div class=“role-card”> <span class=“badge badge-community”>COLABORADOR</span>

Actividades	• Reportar errores y sugerir características vía Issues • Probar nuevas versiones y dar feedback • Compartir casos de uso y aplicaciones • Difundir el paquete en eventos y redes sociales • Pequeñas correcciones (errores tipográficos, enlaces rotos)
Perfil	Entusiastas de datos, estudiantes, profesionales de salud, investigadores principiantes — ¡todos son bienvenidos!
Requisitos	• Cuenta en GitHub • Interés en datos de clima y salud • Deseo de participar en la comunidad
Primeros Pasos	1. ⭐ Dale Star al repositorio para seguir las actualizaciones 2. 📖 Lee la documentación y prueba los ejemplos 3. 🐛 ¿Encontraste un problema? ¡Abre un Issue! 4. 💡 ¿Tienes una idea? Inicia una Discussion 5. 🗣️ Cuéntale a tus colegas sobre el proyecto

</div>

Cómo Elegir tu Perfil

<div class=“callout-box”> <strong>¿Aún no sabes por dónde empezar?</strong>

Responde a estas rápidas preguntas:

<ul> <li><strong>Quiero escribir código y tengo experiencia:</strong> → Desarrollador Senior o Ingeniero de Software</li> <li><strong>Quiero escribir código pero estoy aprendiendo:</strong> → Desarrollador Asistente</li> <li><strong>Soy investigador y quiero usar el paquete:</strong> → Asistente de Investigación</li> <li><strong>Soy especialista en métodos:</strong> → Consultor Científico</li> <li><strong>Me gusta escribir y ayudar a las personas:</strong> → Documentación y Soporte</li> <li><strong>Quiero ayudar sin un compromiso fijo:</strong> → Contribuidor del Proyecto</li> </ul> </div>

Proceso de Onboarding

Lee el Código de Conducta — Todos los roles exigen respeto mutuo
Explora el Repositorio — Familiarízate con la estructura y la documentación existente
Preséntate — En la pestaña Discussions, preséntate y menciona tu interés
Empieza Pequeño — Elige una tarea sencilla para tu primer contacto
Crece Gradualmente — A medida que ganes confianza, asume mayores responsabilidades

<div class=“callout callout-tip”> <strong>Reconocimiento:</strong>
Todos los contribuidores son listados en el sitio web de climasus4r. Las contribuciones significativas son reconocidas en los lanzamientos y publicaciones científicas. </div>

¿Listo para empezar? 🚀
¡Visita github.com/ByMaxAnjos/climasus4r y forma parte de la comunidad!

Únete a Nosotros en la Construcción de la Próxima Generación de Herramientas de Clima y Salud

Dr. Max Anjos

02 de April de 2026

¿Por Qué Contribuir?

Roles a Desempeñar

🎯 Núcleo de Liderazgo

Coordinador y Desarrollador Principal

💻 Equipo Técnico

Desarrollador R/Python Senior

Ingeniero de Software

Desarrollador R/Python Asistente

🔬 Equipo Científico

Consultor Científico

Asistente de Investigación (Licenciatura, Maestría, Doctorado, Posdoctorado)

🌟 Comunidad y Soporte

Documentación y Soporte

Contribuidor del Proyecto

Cómo Elegir tu Perfil

Proceso de Onboarding