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
Bifurcar un repositorio en la plataforma GitHub crea una copia, también conocida como "bifurcación", de ese repositorio, bajo 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 tenedor botó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 usando el editor basado en web de GitHub.
Para clonar un repositorio en su máquina local usando Git, ejecute este comando de terminal:
git clon
Reemplazar 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 Contribuir desplegable. Al hacer clic en este botón, se le pedirá que abra una solicitud de extracción. Luego, haga clic en el Solicitud de extracción abierta botó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, rellene los campos obligatorios y haga clic en el Crear solicitud de extracción botó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.
