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. Este inicio rápido le guía por la ruta de acceso más sencilla a una solicitud de incorporación de cambios. Creará una rama, realizará y confirmará los cambios, abrirá una solicitud de incorporación de cambios, responderá a los comentarios y combinará.

Puede seguirlo en el GitHub sitio web o con GitHub CLI seleccionando una de las pestañas de arriba.

Crear una rama o hacer un fork del repositorio

Empezará creando un lugar aislado para trabajar.

En GitHub, vaya a la página principal del repositorio para el que desea proponer cambios.
Opcionalmente, si no tiene acceso de escritura, necesitará una bifurcación. Haga clic en Bifurcar en la esquina superior derecha y siga los pasos. Luego, continúa trabajando en tu fork 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, bifurque el repositorio y clonelo localmente al mismo tiempo.

Si tiene acceso de escritura al repositorio, clone el repositorio:
```
gh repo clone OWNER/REPO
```
Si no tiene acceso de escritura, primero creará un fork y lo clonará de una sola 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 .

Confirmar con frecuencia

Guarda tu trabajo en confirmaciones de cambios pequeñas y significativas. 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 hacer commit, introducirás un mensaje de commit y harás commit directamente en 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.

El cambio se añadirá y se registrará en la rama.

Abre tu solicitud de incorporación de cambios

Cuando la rama tenga los cambios que desea proponer, abra una solicitud de incorporación de cambios en 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 ya esté seleccionada la rama principal y normalmente sea la rama base en la que se combinará.
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, use la lista desplegable y seleccione Crear solicitud de incorporación de cambios de borrador.

Puede crear una solicitud de incorporación de cambios lista para revisarla o una que esté en un 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 realiza más confirmaciones en la misma rama, se agregarán automáticamente a la 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 que las revisiones obligatorias y las comprobaciones de estado se hayan completado correctamente, fusione la pull request para integrar los cambios en la rama base. Si decide no combinar los cambios, puede cerrar la solicitud de incorporación de cambios en su lugar.

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.