Guía para Contribuir a KooL Hyprland Projects

Ver versión en inglés

¡Gracias por tu interés en contribuir a KooL Hyprland Projects! Aceptamos todo tipo de contribuciones: correcciones de errores, nuevas características, mejoras en documentación y otras mejoras generales.

Primeros pasos

1. Haz un fork del repositorio de la rama development en tu cuenta de GitHub. Así tendrás una copia sobre la cual trabajar sin afectar el repositorio original.
   - Para hacer fork, pulsa el botón Fork en la esquina superior derecha de esta página o haz clic aquí.
   - Asegúrate de desmarcar la opción de copiar solo la rama main. Así se copiarán la rama development y otras ramas (si existen).

2. Clona tu repositorio bifurcado en tu equipo.

• Usa el siguiente comando para clonar tu fork:

  bash git clone --depth=1 -b development https://github.com/LinuxBeginnings/Hyprland-Dots.git

3. Crea una rama nueva para tus cambios.

• Por ejemplo, para crear una rama llamada tu-rama, ejecuta:

  bash git checkout -b tu-rama

4. Realiza tus cambios y haz commit con un mensaje descriptivo.

• Por ejemplo, para hacer commit de tus cambios, ejecuta (siguiendo la guía de mensajes de commit):

  bash git commit -m "feat: add a new feature"

5. Empuja tu rama a tu fork.

bash git push origin tu-rama

6. Abre un pull request contra el repositorio en la rama development.
   - Pasos sugeridos:
   1. Ve a tu fork en GitHub.
   2. Haz clic en Compare & pull request junto a tu rama.
   3. Añade un título y una descripción.
   4. Pulsa Create pull request y recuerda añadir las etiquetas correspondientes usando la plantilla de PR.

Directrices

• Sigue el estilo de código del proyecto.
• Actualiza la documentación si es necesario.
• Añade tests cuando corresponda.
• Asegúrate de que todos los tests pasen o que los cambios estén probados antes de enviar.
• Mantén tu PR enfocado y evita incluir cambios no relacionados.
• Revisa estos archivos antes de enviar tus cambios:
• bug.yml – Reporte de errores.
• feature.yml – Sugerir características.
• documentation-update.yml – Cambios de documentación.
• PULL_REQUEST_TEMPLATE.md – Plantilla de PR.
• COMMIT_MESSAGE_GUIDELINES.md – Guía de mensajes de commit.
• CONTRIBUTING.md – Guía en inglés.
• LICENSE – Licencia.
• README.md – Proyecto.

Contacto

Si tienes preguntas, utiliza GitHub Discussions o el Servidor de Discord.