Cómo contribuir

Formas de participar y buenas prácticas al colaborar en repositorios y espacios de Coderic.

Gracias por tu interés en contribuir. Esta guía resume cómo participar de forma útil y respetuosa en los proyectos de Coderic.

Todas las interacciones deben cumplir el código de conducta.

Formas de contribuir

Hay muchas formas de contribuir; todas son valiosas.

Reportar problemas

  1. Busca si ya existe un issue relacionado.
  2. Si no existe, abre uno en el repositorio correspondiente.
  3. Incluye pasos para reproducir, comportamiento esperado vs. actual y entorno (versión, SO, etc.).

Mejorar documentación

  • Corregir erratas y aclarar explicaciones.
  • Añadir ejemplos o casos de uso.
  • Traducir o completar documentación faltante.

Contribuir código

  1. Haz fork del repositorio.
  2. Crea una rama (git checkout -b feature/descripcion-breve).
  3. Commits con mensajes claros.
  4. Push a tu fork y abre un Pull Request contra la rama indicada por el proyecto (habitualmente main).

Diseño, eventos y otras aportaciones

Interfaces, identidad visual, meetups, charlas y organización comunitaria también cuentan como contribución.

Estándares

  • Código de conducta: código de conducta.
  • Calidad: respeta linting, pruebas y convenciones del repositorio.
  • Documentación: documenta APIs o comportamiento público nuevo.
  • Revisión: responde a comentarios de mantenedores.

Pull requests

  1. Describe el cambio y el motivo.
  2. Verifica que las pruebas pasen.
  3. Actualiza documentación si aplica.
  4. Mantén el PR enfocado; divide cambios grandes cuando sea posible.

Ramas (orientación general)

  • Rama principal de integración (p. ej. main): debe permanecer utilizable según la política del repo.
  • Ramas de trabajo: feature/*, fix/* o la convención que indique cada proyecto.

Contribuciones pequeñas vs. grandes

  • Pequeñas (typos, ajustes menores): suelen revisarse con rapidez.
  • Grandes: abre antes un issue para alinear el enfoque con mantenedores.

Comunicación

  • Issues: bugs y trabajo concreto en el repo.
  • Discusiones (cuando el repo las tenga): preguntas generales.
  • Correo [email protected] para temas que no encajen en GitHub.

Preguntas frecuentes

¿Hace falta ser experto? No. Reportar bugs y mejorar documentación ya es una gran ayuda.

¿Por dónde empiezo? Revisa issues etiquetados como good first issue o pregunta en el canal de discusión del proyecto.

¿Y si rechazan mi PR? El feedback busca mejorar el cambio; itera con calma.

¿Puedo contribuir sin código? Sí: documentación, diseño, traducción, eventos, etc.

Contacto