diff --git a/CODE_OF_CONDUCT.es.md b/CODE_OF_CONDUCT.es.md new file mode 100644 index 0000000..cb7b00f --- /dev/null +++ b/CODE_OF_CONDUCT.es.md @@ -0,0 +1,81 @@ +# Código de Conducta del Pacto del Colaborador + +[Ver versión en inglés](./CODE_OF_CONDUCT.md) + +## Nuestro compromiso + +Nosotros, como miembros, contribuyentes y líderes, nos comprometemos a hacer que la participación en nuestra comunidad sea una experiencia libre de acoso para todas las personas, sin distinción de edad, complexión, discapacidad visible o invisible, etnia, características sexuales, identidad y expresión de género, nivel de experiencia, educación, situación socioeconómica, nacionalidad, apariencia personal, raza, religión, orientación o identidad sexual. + +Nos comprometemos a actuar e interactuar de maneras que contribuyan a una comunidad abierta, acogedora, diversa, inclusiva y saludable. + +## Nuestros estándares + +Ejemplos de comportamiento que contribuye a un entorno positivo para nuestra comunidad incluyen: + +- Demostrar empatía y amabilidad hacia otras personas. +- Ser respetuoso con opiniones, puntos de vista y experiencias que difieran de las nuestras. +- Dar y aceptar con gracia retroalimentación constructiva. +- Asumir la responsabilidad y disculparse ante quienes se vean afectados por nuestros errores, y aprender de la experiencia. +- Centrarse en lo que es mejor no solo para nosotros como individuos, sino para la comunidad en su conjunto. + +Ejemplos de comportamiento inaceptable incluyen: + +- El uso de lenguaje o imágenes sexualizadas, y cualquier tipo de atención o insinuación sexual. +- Troleo, comentarios insultantes o despectivos, y ataques personales o políticos. +- Acoso público o privado. +- Publicación de información privada de otras personas, como direcciones físicas o de correo electrónico, sin su permiso explícito. +- Otra conducta que, razonablemente, pudiera considerarse inapropiada en un entorno profesional. + +## Responsabilidades de cumplimiento + +Los líderes de la comunidad son responsables de aclarar y hacer cumplir nuestros estándares de comportamiento aceptable y tomarán medidas correctivas apropiadas y justas en respuesta a cualquier comportamiento que consideren inapropiado, amenazante, ofensivo o dañino. + +Los líderes de la comunidad tienen el derecho y la responsabilidad de eliminar, editar o rechazar comentarios, confirmaciones de cambios (commits), código, ediciones del wiki, incidencias y otras contribuciones que no estén alineadas con este Código de Conducta, y comunicarán los motivos de las decisiones de moderación cuando corresponda. + +## Alcance + +Este Código de Conducta se aplica a todos los espacios de la comunidad y también cuando una persona representa oficialmente a la comunidad en espacios públicos. Ejemplos de representar a nuestra comunidad incluyen usar una dirección de correo electrónico oficial, publicar a través de una cuenta oficial en redes sociales o actuar como representante designado en un evento en línea o presencial. + +## Cumplimiento + +Los casos de comportamiento abusivo, acosador o de otra forma inaceptable pueden ser reportados a los líderes de la comunidad responsables del cumplimiento en mail[at]ml4w.com. Todas las quejas serán revisadas e investigadas de manera rápida y justa. + +Todos los líderes de la comunidad están obligados a respetar la privacidad y seguridad de quien reporte cualquier incidente. + +## Guías de aplicación + +Los líderes de la comunidad seguirán estas Guías de Impacto Comunitario para determinar las consecuencias por cualquier acción que consideren en violación de este Código de Conducta: + +### 1. Corrección + +Impacto comunitario: Uso de lenguaje inapropiado u otro comportamiento considerado no profesional o no bienvenido en la comunidad. + +Consecuencia: Una advertencia privada y por escrito de parte de los líderes de la comunidad, brindando claridad sobre la naturaleza de la violación y una explicación de por qué el comportamiento fue inapropiado. Se puede solicitar una disculpa pública. + +### 2. Advertencia + +Impacto comunitario: Una violación por un incidente único o una serie de acciones. + +Consecuencia: Una advertencia con consecuencias para comportamientos continuados. Ninguna interacción con las personas involucradas, incluida la interacción no solicitada con quienes hacen cumplir el Código de Conducta, por un período de tiempo especificado. Esto incluye evitar interacciones en espacios de la comunidad así como en canales externos como redes sociales. Violaciones a estos términos pueden llevar a una suspensión temporal o permanente. + +### 3. Suspensión temporal + +Impacto comunitario: Una violación grave de los estándares de la comunidad, incluido el comportamiento inapropiado sostenido. + +Consecuencia: Una suspensión temporal de cualquier tipo de interacción o comunicación pública con la comunidad por un período de tiempo especificado. No se permite interacción pública o privada con las personas involucradas, incluida la interacción no solicitada con quienes hacen cumplir el Código de Conducta, durante este período. Violar estos términos puede llevar a una suspensión permanente. + +### 4. Suspensión permanente + +Impacto comunitario: Demostrar un patrón de violación de los estándares de la comunidad, incluido el comportamiento inapropiado sostenido, acoso a una persona o agresión o desprecio hacia clases de individuos. + +Consecuencia: Suspensión permanente de cualquier tipo de interacción pública dentro de la comunidad. + +## Atribución + +Este Código de Conducta está adaptado del [Contributor Covenant][homepage], versión 2.0, disponible en https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. + +Las Guías de Impacto Comunitario se inspiraron en la [escala de aplicación del código de conducta de Mozilla](https://github.com/mozilla/diversity). + +[homepage]: https://www.contributor-covenant.org + +Para respuestas a preguntas comunes sobre este código de conducta, vea las preguntas frecuentes en https://www.contributor-covenant.org/faq. Traducciones disponibles en https://www.contributor-covenant.org/translations. \ No newline at end of file diff --git a/COMMIT_MESSAGE_GUIDELINES.es.md b/COMMIT_MESSAGE_GUIDELINES.es.md new file mode 100644 index 0000000..8788873 --- /dev/null +++ b/COMMIT_MESSAGE_GUIDELINES.es.md @@ -0,0 +1,148 @@ +# Guía para Mensajes de Commit + +[Ver versión en inglés](./COMMIT_MESSAGE_GUIDELINES.md) + +Un buen mensaje de commit debe ser descriptivo y aportar contexto sobre los cambios realizados. Esto facilita entender y revisar los cambios en el futuro. + +## Recomendaciones + +- Empieza con un resumen breve de los cambios del commit. +- Usa el modo imperativo en el resumen, como si dieras una instrucción. Por ejemplo, "Add feature" en lugar de "Added feature". +- Proporciona detalles adicionales en el cuerpo del mensaje, si es necesario: motivo del cambio, impacto, dependencias añadidas o eliminadas, etc. +- Mantén cada línea en 72 caracteres o menos para que sea fácil de leer en la salida de `git log`. + +### Ejemplos de buenos mensajes + +- "Add authentication feature for user login" +- "Fix bug causing application to crash on startup" +- "Update documentation for API endpoints" + +Recordatorio: escribir mensajes de commit descriptivos ahorra tiempo en el futuro y ayuda a otras personas a entender los cambios hechos al código. + +## Tipos de commit + +A continuación, una lista (ampliable) de tipos de commit que puedes usar: + +`feat`: Añade una característica nueva al proyecto + +```markdown +feat: Add multi-image upload support +``` + +`fix`: Corrige un error o problema en el proyecto + +```markdown +fix: Fix bug causing application to crash on startup +``` + +`docs`: Cambios en documentación + +```markdown +docs: Update documentation for API endpoints +``` + +`style`: Cambios cosméticos o de formato (colores, formateo de código, etc.) + +```markdown +style: Update colors and formatting +``` + +`refactor`: Cambios internos que no alteran el comportamiento, pero mejoran calidad/mantenibilidad + +```markdown +refactor: Remove unused code +``` + +`test`: Añadir o modificar tests + +```markdown +test: Add tests for new feature +``` + +`chore`: Cambios que no encajan en otras categorías (actualizar dependencias, configurar build, etc.) + +```markdown +chore: Update dependencies +``` + +`perf`: Mejoras de rendimiento + +```markdown +perf: Improve performance of image processing +``` + +`security`: Aborda temas de seguridad + +```markdown +security: Update dependencies to address security issues +``` + +`merge`: Fusiones de ramas + +```markdown +merge: Merge branch 'feature/branch-name' into develop +``` + +`revert`: Revertir un commit previo + +```markdown +revert: Revert "Add feature" +``` + +`build`: Cambios en el sistema de build o dependencias + +```markdown +build: Update dependencies +``` + +`ci`: Cambios en la integración continua (CI) + +```markdown +ci: Update CI configuration +``` + +`config`: Cambios en archivos de configuración + +```markdown +config: Update configuration files +``` + +`deploy`: Cambios en el proceso de despliegue + +```markdown +deploy: Update deployment scripts +``` + +`init`: Inicialización de repositorio o proyecto + +```markdown +init: Initialize project +``` + +`move`: Mover archivos o directorios + +```markdown +move: Move files to new directory +``` + +`rename`: Renombrar archivos o directorios + +```markdown +rename: Rename files +``` + +`remove`: Eliminar archivos o directorios + +```markdown +remove: Remove files +``` + +`update`: Actualización de código, dependencias u otros componentes + +```markdown +update: Update code +``` + +Estos son solo ejemplos; puedes definir tipos personalizados si los usas de forma consistente y con mensajes claros y descriptivos. + +**Importante:** Si planeas usar un tipo de commit personalizado que no esté en la lista, añádelo aquí para que otras personas lo entiendan también. Crea un pull request para incluirlo en este archivo. diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md new file mode 100644 index 0000000..41fcfbc --- /dev/null +++ b/CONTRIBUTING.es.md @@ -0,0 +1,58 @@ +# Guía para Contribuir a KooL Hyprland Projects (Debian) + +[Ver versión en inglés](./CONTRIBUTING.md) + +¡Gracias por tu interés en contribuir! Aceptamos correcciones de errores, nuevas características, mejoras de documentación y otras mejoras generales. + +## Primeros pasos + +1. Haz un fork del repositorio (rama `development`) en tu cuenta de GitHub. + - Botón **Fork** o [enlace directo](https://github.com/JaKooLit/Debian-Hyprland/fork). + - Desmarca la opción de copiar solo la rama `main` para incluir `development` y otras ramas. + +2. Clona tu fork en tu equipo: + + ```bash + git clone --depth=1 -b development https://github.com/JaKooLit/Debian-Hyprland.git + ``` + +3. Crea una rama para tus cambios: + + ```bash + git checkout -b tu-rama + ``` + +4. Realiza tus cambios y crea un commit con mensaje descriptivo (sigue la [guía de commits](./COMMIT_MESSAGE_GUIDELINES.md)): + + ```bash + git commit -m "feat: add a new feature" + ``` + +5. Sube tu rama a tu fork: + + ```bash + git push origin tu-rama + ``` + +6. Abre un **pull request** contra `development`. + - Usa la [plantilla de PR](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/PULL_REQUEST_TEMPLATE.md) y añade etiquetas relevantes. + +## Directrices + +- Sigue el estilo de código del proyecto. +- Actualiza la documentación cuando sea necesario. +- Añade tests si aplica y verifica que pasen. +- Mantén el PR enfocado; evita cambios no relacionados. +- Revisa estos archivos útiles: + - [bug.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/bug.yml) + - [feature.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/feature.yml) + - [documentation-update.yml](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/ISSUE_TEMPLATE/documentation-update.yml) + - [PULL_REQUEST_TEMPLATE.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/.github/PULL_REQUEST_TEMPLATE.md) + - [COMMIT_MESSAGE_GUIDELINES.md](./COMMIT_MESSAGE_GUIDELINES.md) + - [CONTRIBUTING.md](./CONTRIBUTING.md) + - [LICENSE](https://github.com/JaKooLit/Debian-Hyprland/blob/main/LICENSE.md) + - [README.md](https://github.com/JaKooLit/Debian-Hyprland/blob/main/README.md) + +## Contacto + +Para preguntas, usa [GitHub Discussions](https://github.com/JaKooLit/Debian-Hyprland/discussions) o el [Servidor de Discord](https://discord.gg/kool-tech-world).