Traducción de Forking Projects. 2014.02.06.
- Contribuyendo a un proyecto
- Haciendo un Fork del repositorio
- Clona tu Fork
- Haciendo un Pull Request
- ¡Fuuaa!
Después de utilizar GitHub tu solo por un tiempo, tal vez estés esperando contribuir en el proyecto de alguien más. O quizás quieras utilizar el proyecto de alguien más como punto de partida para tu propio proyecto. Éste proceso se conoce como forking.
Crear un "fork" es producir un copia personal del proyecto de alguien más. La acción de Fork es un puente entre el repositorio original y tu copia personal. Puedes enviar un Pull Request para ayudar o contribuir al proyecto de otras personas ofreciendo tus cambios al proyecto original. Hacer Forking es el núcleo de la programación social en GitHub.
Para este tutorial, utilizaremos el proyecto Spoon-Knife, un repositorio de prueba que esta alojado en GitHub.com y que permite hacer pruebas para Pull Request.
Para hacer un fork del repositorio del proyecto Spoon-Knife, da clic en el botón de Fork que está en la parte superior del repositorio.
Siéntate cómodo y observa la magia del proceso de forking. Cuando termine, tendrás tu propia copia del repositorio del proyecto Spoon-Knife.
Ya lograste un fork exitoso del repositorio Spoon-Knife, pero hasta ahora, solo existe en GitHub. Para poder trabajar en el proyecto, necesitas clonarlo a tu computadora.
Si estás utilizando la aplicación de GitHub para Escritorio, este proceso es cosa fácil. Debajo del titulo GitHub.com en la barra lateral, da clic en tu avatar o nombre de cuenta, y comienza a teclear el nombre de "Spoon-Knife". Verás un botón que dice Clonar a tu Computadora. Dando clic en éste, clonas el repositorio en tu computadora.
Adelante, haz algunos cambios al proyecto utilizando tu editor de texto favorito, como Notepad++ o Sublime Text. Podrías, por ejemplo, cambiar el texto en index.html y agregar tu nombre de usuario de GitHub.
Cuando estés listo para enviar los cambios, escribe un resumen commit en la aplicación de GitHub para Escritorio, y da clic en Commit.
En este momento le haz dicho a Git, "Bien, toma un snapshot de mis cambios" Puedes continuar haciendo más cambios, y tomar más snapshots de commit. Cuando estés listos para enviar tus cambios a GitHub.com, da clic en el botón de Sync, que esta arriba a la derecha de tu lista de cambios.
Al final, estás listo para proponer cambios en el proyecto principal. Éste es el paso final en la producción de un fork del proyecto de alguien más, y podría decirse que el más importante. Si hiciste un cambio que sientes que podría beneficiar a la comunidad, definitivamente deberías considerar envíar tu contribución.
Para hacerlo, ve al repositorio en GitHub.com donde esta tu copia del proyecto. Por ejemplo, algo así:
https://www.github.com/<tu_nombre_de_usuario>/Spoon-Knife. Verás un banner indicando que recientemente haz enviado una nueva rama (branch), y que puedes enviar está rama "un-nivel-arriba", al repositorio original.
Dando clic en botón de Compare and Pull Request te envía a la página de discusiones, donde puedes ingresar un titulo y una descripción opcional. Es importante proveer la mayor información posible de por qué estás haciendo este Pull Request en primer lugar. El dueño del proyecto lo necesita para poder determinar si tus cambios son tan útiles para todos como tu lo crees.
Cuando hayas terminado de escribir todo tu argumento cordialmente escrito, da clic en Send pull request, y ¡Listo!
Tú Pull Request está ahora en área de discusión. En este caso, el Octocat esta muy ocupado, y probablemente no merge tus cambios. Para otros proyectos, no te sientas ofendido si el dueño del proyecto rechaza tu Pull Request, o te pide más información de por qué hiciste tales cambios. Puede incluso que le dueño del proyecto decida no merge tu pull request, y eso es totalmente válido. Tu copia seguirá existiendo en Internet. Y quien sabe – tal ves alguien que no conozcas encuentre tus cambios mucho más valiosos que el proyecto original.
Haz hecho un fork exitoso y haz contribuido de vuelta a un repositorio. Sigue adelante, y contribuye algo más.