Guía de inicio rápido para solicitudes de incorporación de cambios

Una solicitud de incorporación de cambios propone cambios en una rama independiente de la base de código principal para que otros usuarios puedan revisar los cambios antes de combinarlos. Esta guía de inicio rápido te muestra la ruta más sencilla para crear una solicitud de extracción. Crearás una rama, realizarás y confirmarás cambios, abrirás una solicitud de extracción, responderás a los comentarios y fusionarás.

Puedes seguir los pasos en el GitHub sitio web o con GitHub CLI seleccionando una de las pestañas de arriba.

Crea una rama o bifurca el repositorio

Empezará creando un lugar aislado para trabajar.

En GitHub, vaya a la página principal del repositorio para el que desea proponer cambios.
Si no tienes acceso de escritura, tendrás que crear una bifurcación. Haga clic en Bifurcar en la esquina superior derecha y siga los pasos. A continuación, continúa en tu bifurcación del repositorio.
Haga clic en el menú del selector de rama en la parte superior de la lista de archivos. Probablemente dice main. Escriba un nuevo nombre de rama y haga clic en Crear rama new-branch-name desde main.

Para usar GitHub CLI, primero deberá instalarlo. Consulte Inicio rápido de la CLI de GitHub.
Clone el repositorio. O bien, bifurca el repositorio y clónalo localmente al mismo tiempo.

Si tiene acceso de escritura al repositorio, clone el repositorio:
```
gh repo clone OWNER/REPO
```
Si no tienes acceso de escritura, primero crearás una bifurcación y la clonarás todo de una vez.
```
gh repo fork OWNER/REPO --clone
```

Cambie al directorio del repositorio clonado.
```
cd REPO
```
Cree una nueva rama y cámbiese a ella.
```
git checkout -b YOUR-BRANCH-NAME
```

Creación o edición del código

Realice los cambios en la rama. Para tu primer pull request, procura que el cambio sea específico y sencillo. Las solicitudes de extracción más pequeñas son más rápidas de revisar y más fáciles de fusionar.

Pruebe uno de los siguientes pasos para realizar los cambios:

Edite archivos localmente en el IDE o en un editor de texto.
Edite un archivo directamente en GitHub navegando hasta él y haciendo clic en .

Realiza commits con frecuencia

Guarda tu trabajo en commits pequeños y significativos. Cada confirmación registra una instantánea y un mensaje que describe el cambio.

git add .
git commit -m "Describe your change"
git push --set-upstream origin YOUR-BRANCH-NAME

Cuando edites un archivo en GitHub y estés listo para realizar un commit, introducirás un mensaje de commit y lo enviarás directamente a tu rama.

Haga clic en Confirmar cambios....
En el cuadro Confirmar mensaje , escriba una breve descripción de los cambios realizados.
Seleccione la rama en la que está trabajando.
Haz clic en Proponer cambios.

Tu cambio se añadirá y se confirmará en la rama.

Abre tu solicitud de incorporación de cambios

Cuando tu rama contenga los cambios que deseas proponer, abre una solicitud de incorporación de cambios (pull request) dirigida a la rama base.

En la página principal del repositorio, haga clic en Solicitudes de incorporación de cambios y, a continuación, haga clic en Nueva solicitud de incorporación de cambios.
Para la rama base, es probable que main ya esté seleccionada y, por lo general, es la rama base en la que realizarás la fusión.
En la rama de comparación , seleccione la rama que contiene los cambios.
Haga clic en Crear solicitud de incorporación de cambios.
Escriba un título y una descripción que explique lo que ha cambiado y por qué.
Puede crear una solicitud de incorporación de cambios lista para revisión o una en estado de borrador.

Si está listo para su revisión, haga clic en Crear solicitud de incorporación de cambios.
Para compartir un trabajo en curso, utiliza el menú desplegable y selecciona Crear solicitud de incorporación de cambios (borrador).

Puedes crear una solicitud de incorporación de cambios lista para su revisión o una que se encuentre en estado de borrador.

Si está listo para su revisión:
```
gh pr create
```
Para compartir un trabajo en curso
```
gh pr create --draft
```

A continuación, siga las indicaciones para establecer la rama base, el título y la descripción.

Si realizas más confirmaciones en la misma rama, se añadirán automáticamente a tu solicitud de incorporación de cambios.

Solicitar una revisión

Para solicitar una revisión a través del cuadro Revisores , necesita acceso de escritura al repositorio y puede solicitar una revisión de una persona o equipo con acceso de lectura al repositorio. Si solicita una revisión, la persona o el equipo recibirán una notificación. En algunos casos, verá revisores sugeridos entre los que puede seleccionar.

Si el cuadro Revisores no está disponible para usted, puede hacer lo siguiente:

Consulte el archivo README del repositorio para conocer sus indicaciones sobre las revisiones de pull requests y siga sus instrucciones.
Si conoce a una persona que puede hacer la revisión para usted, póngase en contacto con ellos y comparta el vínculo a la solicitud de incorporación de cambios.

Abordar los comentarios de la revisión

Los revisores pueden comentar, sugerir cambios o solicitar cambios antes de que se pueda fusionar una pull request.

Para aceptar la sugerencia de un revisor, haga clic en Confirmar sugerencia (o por lotes varias y haga clic en Confirmar sugerencias).
Para realizar cambios más amplios, edite el código e inserte nuevas confirmaciones en la misma rama. La solicitud de incorporación de cambios se actualiza automáticamente y volverá a ejecutar las comprobaciones.
Marque cada conversación como Resuelta una vez que la haya abordado.

Combinar e implementar

Una vez superadas las revisiones y comprobaciones de estado necesarias, fusiona la solicitud de incorporación de cambios para incorporar tus cambios a la rama base. Si decides no fusionar los cambios, puedes cerrar la solicitud de extracción.

Sugerencia

Los distintos repositorios pueden tener requisitos diferentes para la combinación. Revise las instrucciones pertinentes y siga sus instrucciones.

En la parte inferior de la solicitud de incorporación de cambios, haga clic en Combinar solicitud de incorporación de cambios.
Haga clic en Confirmar para completar la combinación.
(Opcional) Elimine la rama principal para mantener el repositorio ordenado.

gh pr merge

Siga las indicaciones para elegir un método de combinación y, opcionalmente, elimine la rama.

Pasos siguientes

Después de su primera pull request, intente revisar el trabajo de otra persona. Consulte Inicio rápido para revisar las solicitudes de incorporación de cambios.