Contribuyendo al Equipo Full-Stack
¡Gracias por considerar contribuir al Equipo Full-Stack! Tus contribuciones son invaluables para mejorar la plataforma y crear una solución robusta de gestión de código abierto para freelancers y profesionales. Esta guía proporciona instrucciones y buenas prácticas para contribuir al proyecto.
Índice
- Cómo Contribuir
- Código de Conducta
- Introducción
- Estrategia de Ramificación
- Proceso de Solicitud de Incorporación
Cómo Contribuir
Agradecemos diversos tipos de contribuciones, incluyendo:
- Reportar errores y enviar solicitudes de funcionalidad.
- Redactar documentación y mejorar la existente.
- Contribuir con código para nuevas funcionalidades, corrección de errores y mejoras. - Mejorar la cobertura de pruebas y garantizar la estabilidad de la plataforma.
Código de Conducta
Lea y respete nuestro Código de Conducta para fomentar una comunidad acogedora y respetuosa.
Primeros pasos
- Bifurcar el repositorio:
- Vaya al repositorio y haga clic en "Bifurcar".
- Clonar su bifurcación:
git clone https://github.com/your-username/tfst.git
cd tfst
- Configurar el proyecto:
- Siga la Guía de instalación para configurar el backend y el frontend localmente.
Gestión de ramas
Nuestro proyecto sigue la siguiente estrategia de ramificación:
- La rama dev es la rama principal de desarrollo. Todas las características y correcciones deben derivarse de dev.
- Usar nombres de rama como:
feature/short-description
fix/issue-id
docs/short-description
- Crear solicitudes de extracción (PR) dirigidas a dev.
- Las PR fusionadas a dev se implementan automáticamente en nuestro entorno de pruebas.
- La rama main es la rama de producción.
- Solo un grupo restringido de colaboradores puede crear PR para main.
- Las PR para main se utilizan para implementaciones de producción.
Flujo de trabajo para Pull Requests
- Crear una rama:
git checkout -b feature/your-feature-name
- Realizar los cambios: Asegurarse de que el código tenga el formato correcto y de que todas las pruebas sean correctas.
- Confirmar y enviar:
git add . git commit -m "Añadir descripción de los cambios"
git push origin feature/your-feature-name
- Abrir un Pull Request:
- Acceder al repositorio original en GitHub.
- Hacer clic en la pestaña Solicitudes de extracción y luego en Nueva Pull Request.
- Proporcionar un título descriptivo y resumir los cambios en la descripción de la Pull Request.
- Vincular la Pull Request a las incidencias relevantes usando
#issue-number
.
- Revisar y fusionar: Un responsable del proyecto revisará tu Pull Request. Prepárate para realizar ajustes según los comentarios.
Comunicación y soporte
Para debates y actualizaciones rápidas, únete a nuestro grupo de WhatsApp.
Si tiene preguntas sobre el proceso de contribución, utilice GitHub Issues o contacte directamente con el responsable del proyecto por correo electrónico a [[email protected]].