Contribuir a través de Github

Contribuye a través de Github

Requisitos

Para poder contribuir a través de solicitudes de extracción, hay varios requisitos previos:

• Saber utilizar un mínimo de Git
• Tener una cuenta de Github
• Tener una bifurcación del proyecto en el que deseas contribuir

Antes de entrar en detalles, será necesario hacer una pequeña puntualización sobre el vocabulario. Aquí hay un pequeño glosario de palabras que usamos constantemente con Git/Github:

• repo: Abreviatura de "Repositorio". Usamos esta palabra para designar un conjunto de archivos versionados con Git.
• branch: Esta es una rama en un proyecto Git. Las ramas le permiten crear una versión paralela del código en algún momento de la historia.
• master: Designa la rama principal del repositorio.
• origen: Designa el repositorio remoto. Alojado en Github, por ejemplo.
• pull request: Esta es la operación que te permite proponer una modificación de código a un proyecto en Github.
• bifurcación: este es un repositorio que es una copia de otro repositorio. Esto le permite partir de un proyecto existente para modificarlo, mejorarlo, corregirlo o hacer otra cosa con él.
• upstream: En el caso de una bifurcación, designa el repositorio de donde proviene la bifurcación.
• fetch: Es la operación que consiste en recuperar datos del remoto localmente.
• push: Esta es la operación que permite enviar datos locales al remoto.

Configuración

Tenedor

Lo primero que debes hacer es ir a Github, para poder crear un fork del proyecto al que deseas contribuir.

Por ejemplo, para contribuir con el cliente Leek Wars, vaya aquí: Leek Wars Client

Luego, simplemente haga clic en el botón "bifurcación" en la parte superior derecha.

Al "bifurcar" el proyecto, Github creará un nuevo repositorio en tu cuenta. Esta será una copia del proyecto original.

Luego obtenga la dirección de su repositorio de github, a través de la dirección URL, o haciendo clic en el botón verde "Clonar o descargar".

Vaya a la ubicación donde desea colocar su repositorio local y use el comando: git clone \ No olvide reemplazar "\".

Listo. Ha creado una bifurcación del proyecto y la ha recuperado localmente, en su máquina. Pero hay una cosa más que hacer para poder seguir usándolo sin preocupaciones en el futuro.

Aguas arriba

Luego, debe configurar upstream, lo que le permitirá actualizar su repositorio desde el del proyecto.

El comando git remote -v le permite listar las direcciones remotas configuradas.

origen https://github.com/YOUR_USERNAME/YOUR_FORK.git (buscar) origen https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Por ahora, debería ver dos direcciones configuradas como origen. Uno en buscar, cuando desea repatriar nuevas funciones desde su remoto, su repositorio alojado en Github. Y la otra en push que, por el contrario, te permite enviar tus noticias locales al repo remoto.

A esto, agregaremos el aguas arriba. Para hacer esto, obtenga la dirección del proyecto que acaba de bifurcar. Siempre a través de la url, o del botón "Clonar o descargar".

El comando para agregar upstream es: git remote add upstream \

Si ejecuta el comando git remote -v nuevamente, ahora debería ver cuatro entradas. Dos para el origen y dos para el ascendente. Cada uno se duplicó en buscar y empujar.

origen https://github.com/YOUR_USERNAME/YOUR_FORK.git (buscar) origen https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) aguas arriba https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (buscar) aguas arriba https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

¡Estás listo para contribuir ahora!

Mantenerse actualizado

(El paso no es necesario si solo bifurca).

Lo más probable es que el proyecto al que está contribuyendo no esté escrito en piedra. Las personas que lo cuidan lo harán evolucionar. Otras contribuciones serán potencialmente aceptadas.

Por lo tanto, su repo puede volverse obsoleto rápidamente. Y eso podría ser un problema.

Si originalmente un archivo contenía "A", y desea enviar una contribución para cambiar esta "A" a "B". Mientras tanto, tal vez alguien más haya hecho un cambio de esta "A" a "C".

Y cuando propongas tu modificación, habrá un conflicto. No se puede cambiar "A" por "B" porque "A" ya no está presente en el archivo.

En definitiva, es importante mantener el repo actualizado para evitar sorpresas desagradables.

No se preocupe, ahora que configuró upstream, ¡será pan comido!

Lo primero que debe hacer es obtener la nueva m