Cómo hacer una solicitud de extracción de GitHub

¿Cómo creo y / o envío una solicitud de extracción a otro repositorio alojado en GitHub?

(Además de la página oficial " Ayuda de GitHub 'Uso de solicitudes de extracción' ",
consulte también " Bifurcación frente a bifurcación en GitHub ", " ¿Cuál es la diferencia entre el origen y el flujo ascendente en GitHub ")

Un par de consejos sobre solicitudes de extracción:

Suponiendo que primero haya bifurcado un repositorio , esto es lo que debe hacer en ese tenedor que posee:

• crear una rama : aísle sus modificaciones en una rama. No cree una solicitud de extracción desde masterdonde pueda tener la tentación de acumular y mezclar varias modificaciones a la vez.
• cambiar la base de esa rama : incluso si ya realizó una solicitud de extracción desde esa rama, al cambiarla por encima de origin/master(asegurándose de que su parche siga funcionando) actualizará la solicitud de extracción automáticamente (no es necesario hacer clic en nada)
• actualice esa rama : si su solicitud de extracción es rechazada, simplemente puede agregar nuevas confirmaciones y / o rehacer su historial por completo: activará su solicitud de extracción existente nuevamente.
• "enfocar" esa rama : es decir, hacer que su tema sea "estricto", no modificar miles de clases y todas las aplicaciones, solo agregar o corregir una característica bien definida, manteniendo pequeños los cambios .
• eliminar esa rama : una vez aceptado, puede eliminar esa rama de forma segura en su bifurcación (y git remote prune origin). La GUI de GitHub le propondrá que elimine su sucursal en su página de solicitud de extracción.

Nota: para escribir la solicitud de extracción en sí, consulte " Cómo escribir la solicitud de extracción perfecta " (enero de 2015, GitHub)

Marzo de 2016: nueva opción de botón de combinación de relaciones públicas: consulte "¿ Confirmaciones de squash de Github desde la interfaz web en la solicitud de extracción después de comentarios de revisión? ".

El mantenedor del repositorio puede elegir merge --squashesos compromisos de relaciones públicas.

Después de una solicitud de extracción

En cuanto al último punto, desde el 10 de abril de 2013, " Botón de combinación rediseñado ", la rama se elimina por usted:

La eliminación de ramas después de fusionar también se ha simplificado.
En lugar de confirmar la eliminación con un paso adicional, eliminamos inmediatamente la rama cuando la elimine y proporcionamos un enlace conveniente para restaurar la rama en caso de que la necesite nuevamente .

Eso confirma la mejor práctica de eliminar la rama después de fusionar una solicitud de extracción.

solicitud de extracción frente a solicitud de extracción

• la solicitud de extracción no es un término oficial "git".
  Git usa el request-pullcomando (!) Para crear una solicitud de fusión:
  "resume los cambios entre dos confirmaciones a la salida estándar e incluye la URL dada en el resumen generado".
  Github lanza su propia versión desde el primer día (febrero de 2008) , pero rediseñó esa característica en mayo de 2010 , afirmando que:

  Pull Request = Compare View + Issues + Commit comments
  

notas electrónicas para "repositorio" (sic)

<humour>

¡Esa (solicitud de extracción) ni siquiera está definida correctamente por GitHub!

Afortunadamente, una verdadera organización de noticias de negocios lo sabría, y hay una nota electrónica para reemplazar pull-replace por 'e-note' :

Así que si sus repos o toria necesita un e-nota ... pedir Fox Business . Ellos están en el saber.

</humour>

Para aprender cómo hacer una solicitud de extracción, acabo de seguir dos páginas de ayuda separadas en Github (enlazadas a continuación como viñetas). Los siguientes comandos de línea de comando son para la Parte 1 . La parte 2 , la solicitud de extracción real, se realiza completamente en el sitio web de Github.

$ git clone https://github.com/tim-peterson/dwolla-php.git
$ cd dwolla-php
$ git remote add upstream https://github.com/Dwolla/dwolla-php.git
$ git fetch upstream
// make your changes to this newly cloned, local repo 
$ git add .
$ git commit -m '1st commit to dwolla'
$ git push origin master

• Parte 1 : bifurcar el repositorio de alguien: https://help.github.com/articles/fork-a-repo

  1. haga clic en el botón 'fork' en el repositorio al que desea contribuir, en este caso: repositorio PHP de Dwolla (Dwolla / dwolla-php)
  2. obtenga la URL de su bifurcación recién creada, en este caso: https://github.com/tim-peterson/dwolla-php.git (tim-peterson / dwolla-php)
  3. escriba la git clone->cd dwolla-php->git remote->git fetchsecuencia anterior para clonar el tenedor en algún lugar de su computadora (es decir, "copiar / pegar", en este caso third_party TimPeterson$:) y sincronizarlo con el repositorio maestro (Dwolla / dwolla-php)
  4. hacer cambios a su repositorio local
  5. escriba la git add->git commit->git pushsecuencia anterior para enviar sus cambios al repositorio remoto, es decir, su bifurcación en Github (tim-peterson / dwolla-php)

• Parte 2 : hacer solicitud de extracción: https://help.github.com/articles/using-pull-requests

  6. vaya a la página web de su tenedor en Github ( https://github.com/tim-peterson/dwolla-php )
  7. haga clic en el botón 'solicitud de extracción'
  8. asigne un nombre a pull-request, complete los detalles de los cambios que realizó, haga clic en el botón Enviar.
  9. ya terminaste !!

Para realizar una solicitud de extracción, debe realizar los siguientes pasos:

1. Bifurca un repositorio (al que deseas hacer una solicitud de extracción). Simplemente haga clic en el botón de la horquilla en la página del repositorio y tendrá un repositorio de github separado precedido por su nombre de usuario de github.
2. Clone el repositorio en su máquina local. El software Github que instaló en su máquina local puede hacer esto por usted. Haga clic en el botón de clonar al lado del nombre del repositorio.
3. Realizar cambios / confirmaciones locales en los archivos
4. sincronizar los cambios
5. vaya a su repositorio bifurcado github y haga clic en el botón verde "Comparar y revisar" junto al botón de rama. (El botón tiene icono - sin texto)
6. Se abrirá una nueva página que muestra sus cambios y luego haga clic en el enlace de solicitud de extracción, que enviará la solicitud al propietario original del repositorio que bifurcó.

Me tomó un tiempo entender esto, espero que esto ayude a alguien.

Comencé un proyecto para ayudar a las personas a hacer su primera solicitud de extracción de GitHub. Puedes hacer el tutorial práctico para hacer tu primer PR aquí

El flujo de trabajo es simple como

• Bifurca el repositorio en github
• Obtenga la URL de clon haciendo clic en el botón de repositorio de clonación
• Ve a la terminal y corre git clone <clone url you copied earlier>
• Haz una rama para los cambios que estás haciendo git checkout -b branch-name
• Haz los cambios necesarios
• Compromete tus cambios git commit
• Empuje sus cambios a su bifurcación en GitHub git push origin branch-name
• Ve a tu bifurcación en GitHub para ver un Compare and pull requestbotón
• Haga clic en él y proporcione los detalles necesarios.

Para aquellos de nosotros que tenemos una cuenta de github.com, pero solo recibimos un mensaje de error desagradable cuando escribimos "git" en la línea de comandos, aquí está cómo hacerlo todo en su navegador :)

1. Igual que Tim y Farhan escribieron: Bifurca tu propia copia del proyecto:
2. Después de unos segundos, será redirigido a su propia copia bifurcada del proyecto:
3. Navegue a los archivos que necesita cambiar y haga clic en "Editar este archivo" en la barra de herramientas:
4. Después de editar, escriba algunas palabras que describan los cambios y luego "Confirmar cambios", igual de bien para la rama maestra (ya que esta es solo su propia copia y no el proyecto "principal").
5. Repita los pasos 3 y 4 para todos los archivos que necesita editar y luego vuelva a la raíz de su copia del proyecto. Allí, haga clic en el botón verde "Comparar, revisar ...":
6. Finalmente, haga clic en "Crear solicitud de extracción" ... y luego en "Crear solicitud de extracción" nuevamente después de haber verificado dos veces el encabezado y la descripción de su solicitud:

Seguí las instrucciones de tim peterson pero creé una rama local para mis cambios. Sin embargo, después de presionar, no estaba viendo la nueva sucursal en GitHub. La solución fue agregar -u al comando push:

git push -u origin <branch>

Escribí un programa bash que hace todo el trabajo de configurar una rama de relaciones públicas para usted. Realiza una bifurcación si es necesario, se sincroniza con el flujo ascendente, configura el control remoto ascendente, etc. y solo necesita confirmar sus modificaciones, enviar y enviar un RP.

Así es como lo ejecutas:

github-make-pr-branch ssh your-github-username orig_repo_user orig_repo_name new-feature

Encontrará el programa aquí y su repositorio también incluye una guía paso a paso para realizar el mismo proceso manualmente si desea comprender cómo funciona, y también información adicional sobre cómo mantener su rama de características actualizada. fecha con el maestro ascendente y otros tidbits útiles.

La solicitud de extracción de GitHub más simple es de la interfaz web sin usar git.

1. Registre una cuenta de GitHub, inicie sesión y luego vaya a la página en el repositorio que desea cambiar.

2. Haz clic en el ícono de lápiz ,

   

   busque texto cerca de la ubicación, realice las ediciones que desee y luego obtenga una vista previa para confirmar. Dele al cambio propuesto una descripción de hasta 50 caracteres y, opcionalmente, una descripción extendida, luego haga clic en el botón Proponer cambio de archivo .

3. Si está leyendo esto, no tendrá acceso de escritura al repositorio (carpetas de proyectos), por lo que GitHub creará una copia del repositorio (en realidad una rama) en su cuenta. Haga clic en el botón Crear solicitud de extracción .

4. Dé una descripción a la solicitud de extracción y agregue cualquier comentario, luego haga clic en el botón Crear solicitud de extracción .