Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
71 lines (36 loc) · 3.67 KB

CONTRIBUTING.md

File metadata and controls

71 lines (36 loc) · 3.67 KB

Guía para Contribuir a WinUI 3 Unpackaged Templates

¡Hola! Estamos encantados de que estés considerando contribuir a la mejora de las plantillas WinUI 3 Unpackaged Templates. Tu ayuda es fundamental para asegurar que estas plantillas sigan siendo robustas y estén actualizadas con el último Windows App SDK.

Tu contribución puede ser de muchas formas: reportando errores, sugiriendo nuevas características o enviando código.

🐛 Reporte de Errores (Bugs)

Si encuentras algún problema o comportamiento inesperado al usar las plantillas, por favor, sigue estos pasos para reportarlo:

  1. Busca en los Issues existentes para ver si el error ya fue reportado. Si ya existe un issue relacionado, puedes añadir tus comentarios e información adicional allí.

  2. Crea un nuevo Issue si no encuentras uno existente.

  3. Incluye la siguiente información:

    • Versión de la Extensión: Indica la versión de las "WinUI 3 Unpackaged Templates" que estás utilizando (ej: v2.0).

    • Versión de Visual Studio: Especifica la versión de VS (ej: Visual Studio 2022 v17.9.6).

    • Pasos para Reproducir: Describe los pasos exactos que seguiste para experimentar el error, empezando por la creación del proyecto.

    • Comportamiento Esperado vs. Real: Explica qué esperabas que sucediera y qué sucedió realmente.

    • Capturas de Pantalla o Registros (Opcional): Adjunta cualquier evidencia que pueda ayudar a diagnosticar el problema.

✨ Solicitud de Características (Feature Requests)

¿Tienes una idea para mejorar las plantillas? ¡Nos encantaría escucharla!

  1. Busca en los Issues para asegurarte de que la característica no ha sido propuesta antes.

  2. Crea un nuevo Issue con la etiqueta Feature Request.

  3. Describe la Característica: Explica claramente la característica o mejora que deseas, y, lo más importante, por qué es útil para los usuarios.

💻 Contribución de Código

Si deseas contribuir directamente con código, como correcciones de errores, mejoras o nuevas plantillas, por favor, sigue el flujo de trabajo estándar de Git:

Antes de Empezar

  • Abre un Issue: Antes de empezar a escribir código para una característica grande o un cambio importante, por favor, abre un Issue primero. Esto nos permite discutir el cambio y asegurarnos de que el trabajo no se duplique.

  • Sigue las convenciones: Asegúrate de que tu código sigue las convenciones de nomenclatura y estilo de C# o C++ de WinUI 3/Windows App SDK.

Proceso de Pull Request (PR)

  1. Haz un Fork del repositorio.

  2. Crea una Rama con un nombre descriptivo (ej: fix/nombre-del-bug o feat/nueva-plantilla).

  3. Realiza tus Cambios: Implementa la corrección o característica en tu rama.

  4. Prueba: Asegúrate de que tus cambios no introduzcan nuevos errores y que las plantillas funcionen correctamente tras la generación.

  5. Haz Commit de tus Cambios: Escribe un mensaje de commit claro y conciso.

  6. Abre un Pull Request (PR):

    • Dirige el PR a la rama principal (main o master) del repositorio original.

    • Describe el PR: Incluye una descripción detallada de los cambios y haz referencia al número de Issue que estás cerrando (ej: Closes #123).

Una vez enviado el PR, lo revisaremos tan pronto como sea posible. Podemos pedirte que realices ajustes si es necesario.

🤝 Conducta del Contribuidor

Al participar en este proyecto, se espera que mantengas un trato respetuoso y profesional hacia los demás contribuidores. Queremos mantener un ambiente de colaboración positivo.

¡Gracias por ser parte de este proyecto!