¡Bienvenidos a nuestro repositorio colaborativo! Aquí encontrarás diversos proyectos en los que puedes participar y contribuir según tus intereses y habilidades. Cada proyecto se encuentra en una carpeta específica y contiene su propio README con más detalles.
Cada proyecto tiene una estructura similar para facilitar la colaboración y la organización:
- Proyectos de ejemplo:
personal-blogtask-manager
Cada proyecto puede tener varias versiones y tipos de implementaciones (backend, frontend, mobile, fullstack). Aquí te mostramos cómo estructurar y nombrar las carpetas:
- Backend:
backend-<framework>- Ejemplo:
backend-express
- Ejemplo:
- Frontend:
client-<framework>- Ejemplo:
client-react
- Ejemplo:
- Mobile:
mobile-<framework>- Ejemplo:
mobile-flutter
- Ejemplo:
- Fullstack:
fullstack-<framework>- Ejemplo:
fullstack-nextjs
- Ejemplo:
Si ya existe una implementación y quieres crear otra versión desde cero, añade un sufijo al nombre:
- Ejemplo:
backend-express-version2
Para contribuir, sigue estos pasos:
- Crear un Issue:
- Título:
[nombre del proyecto][carpeta del framework] Descripción- Ejemplo:
[personal-blog][client-react] Mejorar interfaz de usuario
- Ejemplo:
- Descripción: Detalla la mejora o la nueva funcionalidad que deseas implementar.
- Título:
- Crear un Fork:
- Realiza un fork del repositorio para tener una copia en tu cuenta de GitHub.
- Guía para crear un fork en GitHub
- Crear una Rama:
- Nombra tu rama siguiendo esta convención:
[nombre del proyecto][carpetad dle framework]/[descripción]- Ejemplo:
personal-blog/client/react/mejorar-UI
- Ejemplo:
- Guía para crear ramas en Git
- Nombra tu rama siguiendo esta convención:
- Hacer Cambios y Commit:
- Realiza tus cambios y asegúrate de que estén bien documentados.
- Usa mensajes de commit claros y descriptivos.
- Ejemplo de mensaje de commit:
feat: mejorar interfaz de usuario en client-react - Guía para hacer commits efectivos
- Enviar un Pull Request (PR):
- Título del PR:
[nombre del proyecto][tipo de framework]/[descripción]- Ejemplo:
[personal-blog][client-react] Mejorar interfaz de usuario
- Ejemplo:
- Descripción del PR: Explica los cambios realizados y cómo mejoran o solucionan el problema descrito en el issue.
- Guía para crear un pull request en GitHub
- Título del PR:
-
Notificación:
- Antes de comenzar, crea un issue para notificar a los demás sobre lo que vas a trabajar.
- Revisa los issues existentes para evitar duplicados.
-
Fork y Rama:
- Haz un fork del repositorio principal.
- Crea una nueva rama en tu fork con el nombre adecuado.
-
Desarrollo y Documentación:
- Desarrolla tu contribución siguiendo las guías del proyecto.
- Documenta claramente tus cambios en el README del proyecto correspondiente.
-
Commit y Push:
- Realiza commits regulares y descriptivos.
- Haz push de tu rama al fork en tu cuenta de GitHub.
-
Pull Request:
- Crea un PR hacia el repositorio principal desde tu rama.
- Asegúrate de enlazar tu PR con el issue correspondiente.
Para cualquier duda o sugerencia, no dudes en contactarnos o unirte a nuestro Discord para más soporte y comunicación en tiempo real.
- Guía oficial de Git
- Tutorial de GitHub
- Curso de introducción a React
- Documentación de Express.js
- Documentación de Flutter
- Sé respetuoso y amable con los demás colaboradores.
- Sigue las guías de estilo y las convenciones de codificación del proyecto.
- Asegúrate de que tu código esté bien documentado y probado antes de enviar un pull request.
- No envíes cambios grandes sin discusión previa.
¡Gracias por colaborar y hacer crecer estos proyectos juntos!