¡Gracias por tu interés en contribuir a PHP Switcher! Este documento proporciona directrices para contribuir al proyecto.
Este proyecto y todos los participantes están regidos por nuestro Código de Conducta. Al participar, se espera que respetes este código.
Los bugs se rastrean como issues de GitHub. Crea un issue en el repositorio y proporciona la siguiente información:
- Usa un título claro y descriptivo para identificar el problema
- Describe los pasos exactos para reproducir el problema
- Proporciona ejemplos específicos para demostrar los pasos
- Describe el comportamiento que observaste después de seguir los pasos
- Explica qué comportamiento esperabas ver en su lugar y por qué
- Incluye capturas de pantalla si es posible
Las mejoras también se rastrean como issues de GitHub. Crea un issue en el repositorio y proporciona la siguiente información:
- Usa un título claro y descriptivo para la mejora
- Proporciona una descripción detallada de la mejora sugerida
- Explica por qué esta mejora sería útil para la mayoría de los usuarios
- Haz fork del repositorio
- Crea una rama para tu característica (
git checkout -b feature/amazing-feature) - Realiza tus cambios
- Asegúrate de que el código sigue las convenciones de estilo
- Asegúrate de que todas las pruebas pasan
- Haz commit de tus cambios (
git commit -m 'Add some amazing feature') - Haz push a la rama (
git push origin feature/amazing-feature) - Abre un Pull Request
- Sigue las convenciones de estilo de C#
- Usa nombres descriptivos para variables, métodos y clases
- Escribe comentarios para código complejo
- Mantén los métodos pequeños y enfocados en una sola responsabilidad
- Usa la indentación adecuada (4 espacios)
- Asegúrate de que tu código pasa todas las pruebas existentes
- Añade pruebas para nuevas características
- Asegúrate de que las pruebas cubren tanto los casos de éxito como los de error
- Actualiza la documentación cuando cambies la funcionalidad
- Usa comentarios XML para documentar clases y métodos públicos
- Mantén la documentación actualizada con el código
El equipo de mantenimiento revisará tu Pull Request y puede sugerir cambios o mejoras. Una vez que se aborden todos los comentarios, tu Pull Request será fusionado.
¡Gracias por contribuir a PHP Switcher!