Contribuyendo

¡Gracias por tu interés en contribuir a Coderic! Esta guía te ayudará a entender cómo puedes participar y hacer contribuciones significativas a nuestros proyectos.

Cómo contribuir

Hay muchas formas de contribuir a Coderic, y todas son valiosas:

Reportar problemas

Si encuentras un bug o tienes una sugerencia:

  1. Busca si ya existe un issue relacionado

  2. Si no existe, crea un nuevo issue en el repositorio correspondiente

  3. Proporciona información detallada: pasos para reproducir, comportamiento esperado vs. actual

  4. Incluye información del entorno: versión, sistema operativo, etc.

Mejorar documentación

La documentación siempre puede mejorar:

  • Corrige errores tipográficos o gramaticales

  • Mejora la claridad de las explicaciones

  • Agrega ejemplos o casos de uso

  • Traduce contenido a otros idiomas

  • Agrega documentación faltante

Contribuir código

Para contribuir código:

  1. Fork el repositorio

  2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)

  3. Realiza tus cambios y commit (git commit -m 'Agrega nueva funcionalidad')

  4. Push a tu fork (git push origin feature/nueva-funcionalidad)

  5. Abre un Pull Request

Mejorar diseño

Si te interesa el diseño:

  • Mejora interfaces de usuario

  • Crea assets gráficos

  • Optimiza experiencias de usuario

  • Diseña logos o material grófico

Organizar eventos

Ayuda a organizar:

  • Meetups y eventos locales

  • Conferencias y talleres

  • Sesiones de hackathon

  • Webinars y charlas técnicas

Guías de contribución

Código de conducta

Todas las contribuciones deben seguir nuestro código de conducta. Mantón un ambiente respetuoso y acogedor para todos.

Estándares de código

  • Linting: El código debe pasar las verificaciones de linting

  • Tests: Agrega tests para nuevas funcionalidades

  • Documentación: Documenta funciones y APIs públicas

  • Commits: Usa mensajes de commit claros y descriptivos

Proceso de Pull Request

  1. Describe tu cambio: Explica qué y por qué en la descripción del PR

  2. Tests: Asegúrate de que todos los tests pasen

  3. Documentación: Actualiza la documentación si es necesario

  4. Revisión: Espera la revisión de los mantenedores

  5. Mejoras: Responde a los comentarios y realiza ajustes si es necesario

Branches y versionado

  • main/master: Rama principal, siempre estable

  • develop: Rama de desarrollo activo

  • feature/: Nuevas funcionalidades

  • bugfix/: Correcciones de bugs

  • hotfix/: Correcciones urgentes

Tipos de contribuciones

Pequeóas contribuciones

Para cambios pequeóos (typos, mejoras menores):

  1. Puedes editar directamente en GitHub

  2. El cambio seró revisado y mergeado rópidamente

Contribuciones mayores

Para cambios grandes:

  1. Abre un issue primero para discutir el cambio

  2. Espera feedback antes de comenzar a trabajar

  3. Sigue el proceso completo de Pull Request

Nuevas características

Para proponer nuevas características:

  1. Abre un issue con la etiqueta "enhancement"

  2. Describe la caracteróstica y su justificación

  3. Discute con la comunidad

  4. Si se aprueba, procede con el desarrollo

Herramientas y recursos

Entorno de desarrollo

  • Git: Control de versiones

  • Editor: Usa el editor que prefieras

  • Testing: Herramientas de testing del proyecto

  • Documentación: Herramientas de documentación local

Comunicación

  • GitHub Issues: Para bugs y discusiones técnicas

  • GitHub Discussions: Para preguntas y discusiones generales

  • Email: latam@coderic.org para temas no tócnicos

Recursos de aprendizaje

  • Documentación del proyecto

  • Código existente como referencia

  • Comunidad para hacer preguntas

Reconocimiento

Agradecemos todas las contribuciones. Los contribuidores son reconocidos en:

  • README del proyecto

  • Releases y changelogs

  • Documentación de contribuidores

  • Eventos y comunicaciones de la comunidad

Preguntas frecuentes

¿Necesito ser un experto para contribuiró

No. Las contribuciones de todos los niveles son bienvenidas. Incluso reportar bugs o mejorar documentación es valioso.

¿Cómo elijo en qué trabajaró

Puedes: * Revisar issues etiquetados como "good first issue" * Preguntar en Discussions qué necesita ayuda * Trabajar en algo que te interese personalmente

¿Qué pasa si mi PR es rechazadoó

No te desanimes. El feedback es para mejorar. Revisa los comentarios, haz ajustes y vuelve a intentar.

óPuedo contribuir sin códigoó

¡Absolutamente! Hay muchas formas no técnicas de contribuir: documentación, diseño, organización de eventos, traducción, etc.

Contacto

Si tienes preguntas sobre cómo contribuir:

¡Esperamos tus contribuciones!