Contribuciones de código
En esta guía obtendrás una descripción general del flujo de trabajo de contribución, desde abrir un issue, crear un PR, revisar y fusionar el PR.
Si deseas contribuir con código a este proyecto, sigue los pasos a continuación:
Resuelve un issue
'Read the “', Resuelve un issue, '” section'Revisa nuestros issues existentes^ para encontrar uno que te interese. Puedes reducir la búsqueda usando labels
como filtros. Si encuentras un issue en el que trabajar, eres bienvenido a abrir un PR con una solución.
Realizar cambios
'Read the “', Realizar cambios, '” section'-
Haz un bifurcación del repositorio.
-
Usando GitHub Desktop:
- Comenzar con GitHub Desktop^ te guiará a través de la configuración de Desktop.
- Una vez que Desktop esté configurado, ¡puedes usarlo para bifurcar del repositorio^!
-
Usando la línea de comandos:
- Bifurca del repositorio^ para que puedas hacer tus cambios sin afectar el proyecto original hasta que estés listo para fusionarlos.
-
-
Instala o actualiza Node.js y pnpm a las versiones especificadas en
.prototools
^. -
¡Crea una rama de trabajo y comienza con tus cambios!
-
Escribe pruebas para tus cambios, si aplica.
-
Actualiza la documentación, si es necesario.
Confirma tus cambios
'Read the “', Confirma tus cambios, '” section'Confirma los cambios una vez que estés satisfecho con ellos.
Pull Request
'Read the “', Pull Request, '” section'Cuando hayas terminado con los cambios, crea un pull request, también conocido como PR.
- Completa la plantilla “Listo para revisión” para que podamos revisar tu PR. Esta plantilla ayuda a los revisores a entender tus cambios y el propósito de tu pull request.
- No olvides vincular el PR al issue^ si estás resolviendo uno.
- Activa la casilla para permitir ediciones del mantenedor^ para que la rama pueda ser actualizada para la fusión. Una vez que envíes tu PR, un miembro del equipo de Docs revisará tu propuesta. Podemos hacer preguntas o solicitar información adicional.
- Podemos pedir que se realicen cambios antes de que un PR pueda ser fusionado, ya sea usando cambios sugeridos^ o comentarios en el pull request. Puedes aplicar los cambios sugeridos directamente a través de la interfaz. Puedes hacer cualquier otro cambio en tu fork y luego confirmarlos en tu rama.
- A medida que actualices tu PR y apliques cambios, marca cada conversación como resuelta^.
- Si te encuentras con problemas de fusión, consulta este tutorial de git^ para ayudarte a resolver conflictos de fusión y otros problemas.
¡Tu PR ha sido fusionado!
'Read the “', ¡Tu PR ha sido fusionado!, '” section'¡Felicitaciones! El equipo de StudioCMS te agradece. Tu contribución será parte del próximo lanzamiento.
Ahora que eres parte de la comunidad de StudioCMS, puedes ayudarnos a revisar otros PRs, responder preguntas y ayudar a otros contribuyentes. Si aún no lo has hecho, únete a nuestro Discord^ para conectarte con otros contribuyentes y el equipo de StudioCMS.
¡Y verás tu rostro en la lista de contribuyentes! 🎉