Skip to content

Latest commit

 

History

History
127 lines (92 loc) · 5.27 KB

Readme.md

File metadata and controls

127 lines (92 loc) · 5.27 KB
Raw

Colaboraciones en Proyectos

¡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.

Índice

Estructura del Proyecto

Cada proyecto tiene una estructura similar para facilitar la colaboración y la organización:

  • Proyectos de ejemplo:
    • personal-blog
    • task-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:

Convenciones de Nombres de Carpetas

  • Backend: backend-<framework>
    • Ejemplo: backend-express
  • Frontend: client-<framework>
    • Ejemplo: client-react
  • Mobile: mobile-<framework>
    • Ejemplo: mobile-flutter
  • Fullstack: fullstack-<framework>
    • Ejemplo: fullstack-nextjs

Si ya existe una implementación y quieres crear otra versión desde cero, añade un sufijo al nombre:

  • Ejemplo: backend-express-version2

Colaboración y Control de Versiones

Creación de Issues

Para contribuir, sigue estos pasos:

  1. Crear un Issue:
    • Título: [nombre del proyecto][carpeta del framework] Descripción
      • Ejemplo: [personal-blog][client-react] Mejorar interfaz de usuario
    • Descripción: Detalla la mejora o la nueva funcionalidad que deseas implementar.

Creación de Forks

  1. Crear un Fork:

Creación de Ramas

  1. 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
    • Guía para crear ramas en Git

Realizar Cambios y Commits

  1. 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

  1. 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
    • 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

Flujo de Trabajo

  1. 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.

  2. Fork y Rama:

    • Haz un fork del repositorio principal.
    • Crea una nueva rama en tu fork con el nombre adecuado.

  3. Desarrollo y Documentación:

    • Desarrolla tu contribución siguiendo las guías del proyecto.
    • Documenta claramente tus cambios en el README del proyecto correspondiente.

  4. Commit y Push:

    • Realiza commits regulares y descriptivos.
    • Haz push de tu rama al fork en tu cuenta de GitHub.

  5. Pull Request:

    • Crea un PR hacia el repositorio principal desde tu rama.
    • Asegúrate de enlazar tu PR con el issue correspondiente.

Contacto y Soporte

Para cualquier duda o sugerencia, no dudes en contactarnos o unirte a nuestro Discord para más soporte y comunicación en tiempo real.

Recursos Adicionales

Política de Contribución

  • 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!