Cómo abrir una solicitud de extracción en GitHub

Una solicitud de extracción (PR) es una función de GitHub que le permite proponer cambios en un repositorio al que no tiene acceso de escritura. Los mantenedores del repositorio pueden revisar estos cambios y, si así lo desean, fusionarlos en el repositorio original.

Abrir solicitudes de incorporación de cambios en GitHub es fundamental para contribuir a proyectos de código abierto y colaborar con otros desarrolladores. Aprenda a crear y abrir una solicitud de incorporación de cambios en GitHub en solo unos sencillos pasos.

Paso 1: bifurcar el repositorio

La bifurcación de un repositorio en la plataforma GitHub crea una copia, también conocida como «bifurcación», de ese repositorio, en su cuenta. Bifurcar un repositorio le permite realizar cambios en el código sin afectar el repositorio original.

Para bifurcar un repositorio, navegue a su página principal y haga clic en el botón de bifurcación en la esquina superior derecha:

Complete el nombre del repositorio (bifurcación) y una descripción opcional y haga clic en Crear bifurcación :

Ahora ha creado una copia del repositorio original. Este nuevo repositorio tiene una conexión con el original para que cualquier cambio que realice en el código se pueda comparar fácilmente y volver a fusionar en él.

Paso 2: Realización de cambios en el código

Después de bifurcar el repositorio, es posible que deba clonarlo en su máquina local, según la cantidad y la naturaleza de los cambios que desee proponer. Si está realizando cambios muy simples que no necesita probar, puede hacerlo en línea con el editor basado en web de GitHub .

Para clonar un repositorio en su máquina local usando Git, ejecute este comando de terminal:

git clone <REPOSITORY_URL>


Reemplace <REPOSITORY_URL> con la URL de su repositorio; puede encontrarla en GitHub. Este comando clonará el repositorio en su máquina local, donde podrá experimentar libremente y realizar cambios en el código.

Debe mantener sus cambios pequeños y enfocados, ya que las solicitudes de extracción grandes pueden ser difíciles de revisar y fusionar. Trate de mantener sus cambios específicos para un problema o característica, para que sea más fácil para los mantenedores revisarlos y aceptarlos.

Después de realizar los cambios deseados localmente, confírmelos y empújelos a su bifurcación de GitHub usando Git.

Paso 3: Abrir una solicitud de extracción

Una vez que hayas confirmado tus cambios en GitHub, deberías ver un aviso que te advierte que tu rama está un número de «confirmaciones» por delante del repositorio del que la bifurcaste, por ejemplo:

Haga clic en el menú desplegable Contribuir . Al hacer clic en este botón, se le pedirá que abra una solicitud de extracción. Luego, haga clic en el botón Abrir solicitud de extracción :

Algunos repositorios tienen pautas de contribución específicas, que normalmente puede encontrar en un archivo CONTRIBUTING.md, que debe seguir. Asegúrese de leer y seguir estas pautas antes de enviar una solicitud de extracción.

A continuación, complete los campos obligatorios y haga clic en el botón Crear solicitud de extracción :

Su mensaje de compromiso debe ser claro y conciso, describiendo los cambios que realizó y el razonamiento detrás de ellos. Esto ayudará a los mantenedores a comprender sus cambios y les facilitará la revisión del código.

Una vez que haya creado su extracción, deberá esperar a que los mantenedores del proyecto la revisen y la fusionen o la cierren. Los mantenedores pueden tener sugerencias o comentarios sobre su solicitud de extracción. Esté abierto a los cambios y dispuesto a hacer revisiones si se lo piden.

La importancia de las solicitudes de extracción

Las solicitudes de extracción facilitan la colaboración entre los desarrolladores al permitirles proponer cambios, proporcionar comentarios y revisar el código. Esto ayuda a fomentar un sentido de comunidad y colaboración dentro de un proyecto, lo que genera más contribuciones y un desarrollo más rápido.

Además, las solicitudes de extracción organizan el historial y el control de versiones del proyecto al permitir que los mantenedores realicen un seguimiento de las diferentes versiones del código y los cambios realizados en cada versión.