Contribuir a proyectos

Acerca de las bifurcaciones

Después de utilizar GitHub tú mismo por un tiempo, puede que quieras contribuir con el proyecto de alguien más. O tal vez te gustaría utilizar el proyecto de alguien más como punto inicial de uno propio. A este proceso se le conoce como bifurcación.

Crear una "bifurcación" es producir una copia personal del proyecto de alguien más. Las bifurcaciones son un tipo de puente entre el repositorio original y tu copia personal. Puedes emitir solicitudes de cambios para ayudar a mejorar los proyectos de otras personas al ofrecerles tus cambios para el proyecto original. La bifurcación es el núcleo del desarrollo de código social en GitHub. Para obtener más información, consulte "Bifurcación de un repositorio".

Bifurcar un repositorio

En este tutorial se usa el proyecto Spoon-Knife, un repositorio de prueba hospedado en GitHub.com que le permite probar el flujo de trabajo de la bifurcación y la solicitud de incorporación de cambios.

Vaya al proyecto Spoon-Knife en https://github.com/octocat/Spoon-Knife.
Haga clic en Fork (Bifurcar).
Selecciona un propietario para el repositorio bifurcado.
De forma predeterminada, las bifurcaciones tienen el mismo nombre que sus repositorios primarios. Puedes cambiar el nombre de la bifurcación para distinguirlo aún más.
Opcionalmente, puedes agregar una descripción de la bifurcación.
Elige si quieres copiar solo la rama predeterminada, o bien todas las ramas en la nueva bifurcación. En muchos escenarios de bifurcación, como los de contribución a proyectos de código abierto, solo tienes que copiar la rama predeterminada. De forma predeterminada, solo se copia la rama predeterminada.
Haz clic en Crear bifurcación.

Nota: Si quieres copiar ramas adicionales del repositorio primario, puedes hacerlo desde la página Ramas. Para obtener más información, consulte "Creación y eliminación de ramas en el repositorio".

Clonar una bifurcación

Bifucrcaste el repositorio Spoon-Knife exitosamente pero, hasta ahora, solo existe en GitHub Enterprise Server. Para poder trabajar en el proyecto, necesitarás clonarlo en tu computadora.

Puedes clonar tu bifurcación con la línea de comandos, el GitHub CLI o GitHub Desktop.

En GitHub Enterprise Server, vaya a su bifurcación del repositorio Spoon-Knife.
Encima de la lista de archivos, haga clic en Código.
Copia la dirección URL del repositorio.
- Para clonar el repositorio con HTTPS, en «HTTPS» haz clic en .
- Para clonar el repositorio mediante una clave SSH, incluido un certificado emitido por la entidad de certificación SSH de la organización, haga clic en Usar SSH y luego en .
- Para clonar un repositorio mediante GitHub CLI, haz clic en GitHub CLI y, después, haz clic en . 1. Abra TerminalTerminalGit Bash. 4. Cambia el directorio de trabajo actual a la ubicación en donde quieres clonar el directorio.
Escriba git clone y pegue la dirección URL que ha copiado antes. Tendrá este aspecto, con su nombre de usuario de GitHub Enterprise Server en lugar de YOUR-USERNAME:
```
$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife
```

Presione ENTRAR. Se creará tu clon local.

$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remove: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

Para crear un clon de la bifurcación, use la marca --clone.

gh repo fork repository --clone=true

En el menú File, haga clic en Clone Repository.

1. Haz clic en la pestaña que corresponde a la ubicación del repositorio que deseas clonar. También puede hacer clic en **URL** para especificar manualmente la ubicación del repositorio.

1. Elija el repositorio que quiera clonar en la lista.

1. Haga clic en **Elegir...** y navegue hasta una ruta local donde quiera clonar el repositorio.

1. Haga clic en **Clone** (Clonar).

Hacer y subir cambios

Continúe y realice algunos cambios en el proyecto con su editor de texto favorito, como Visual� Studio Code. Por ejemplo, podría cambiar el texto de index.html para agregar su nombre de usuario de GitHub.

Cuando estés listo para enviar tus cambios, pruébalos y confírmalos. git add . indica a Git que quiere incluir todos sus cambios en la siguiente confirmación. git commit toma una instantánea de esos cambios.

git add .
git commit -m "a short description of the change"

git add .
git commit -m "a short description of the change"

Para obtener más información sobre cómo almacenar provisionalmente y confirmar los cambios en GitHub Desktop, vea "Confirmación y revisión de los cambios en el proyecto".

Cuando pruebas y confirmas archivos, esencialmente le dices a Git "¡Ok, toma una captura de mis cambios!" Puedes seguir haciendo más cambios y tomando más capturas de las confirmaciones.

Ahora mismo, tus cambios solo existen localmente. Cuando estés listo para subir tus cambios a GitHub Enterprise Server, sube tus cambios al remoto.

git push

git push

Para obtener más información sobre cómo insertar cambios en GitHub Desktop, vea "Inserción de cambios en GitHub".

Hacer una solicitud de cambios

¡Por fin, estás listo para proponer cambios en el proyecto principal! Este es el paso final para producir una bifurcación del proyecto de alguien más y, probablemente, el más importante. Si hiciste un cambio que piensas que beneficiará a la comunidad integralmente, debes considerar en retribuir con esta contribución.

Para hacerlo, dirígete al repositorio de GitHub Enterprise Server en donde vive tu proyecto. En este ejemplo, sería https://www.github.com/<your_username>/Spoon-Knife. Verá un banner que indica que la rama está una confirmación por delante de octocat:main. Haga clic en Contribute (Contribuir) y,después, en Open a pull request (Abrir una solicitud de incorporación de cambios).

GitHub Enterprise Server le dirigirá a una página que muestra las diferencias entre la bifurcación y el repositorio octocat/Spoon-Knife. Haga clic en Create pull request (Crear solicitud de incorporación de cambios).

GitHub Enterprise Server te llevará a una página en donde podrás ingresar un título y una descripción de tus cambios. Es importante que proporciones tanta información útil y racional para explicar el porqué de la solicitud de cambios en primer lugar. El propietario del proyecto necesita poder determinar si tu cambio es tan útil para todos como tú piensas que lo es. Por último, haga clic en Create pull request (Crear solicitud de incorporación de cambios).

Adminsitrar la retroalimentación

Las solicitudes de cambios son un área de debate. En este caso, el Octocat está muy ocupado y, probablemente, no fusionará tus cambios. Para el caso de otros proyectos, no te ofendas si el dueño del proyecto rechaza tu solicitud de cambios o pide más información sobre por qué se hizo. Incluso, podría suceder que el propietario del proyecto elija no fusionar tu solicitud de cambios, y esto está totalmente bien. Tu copia existirá en la infamia del internet. Y, quién sabe... Tal vez alguien que jamás hayas conocido pensará que tus cambios son mucho más valiosos que el proyecto original.

Búsqueda de proyectos

Bifurcaste y retribuiste al proyecto de un repositorio con éxito. Continúe contribuyendo.