# Inicio rápido para solicitudes de incorporación de cambios

Propón tu primer cambio y llévalo desde tu primer commit hasta una pull request fusionada.

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.

<div class="ghd-tool webui">

1. En GitHub, vaya a la página principal del repositorio para el que desea proponer cambios.
2. 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.
3. 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**.

</div>

<div class="ghd-tool cli"> 

1. Para usar GitHub CLI, primero deberá instalarlo. Consulte [Inicio rápido de la CLI de GitHub](/es/github-cli/github-cli/quickstart).

2. Clone el repositorio. O bien, bifurque el repositorio y clonelo localmente al mismo tiempo.

* Si tiene acceso de escritura al repositorio, clone el repositorio:

  ```shell
  gh repo clone OWNER/REPO
  ```

* Si no tiene acceso de escritura, primero creará un **fork** y lo clonará de una sola vez.

  ```shell
  gh repo fork OWNER/REPO --clone
  ```

1. Cambie al directorio del repositorio clonado.

   ```shell
   cd REPO
   ```

2. Cree una nueva rama y cámbiese a ella.

   ```shell
   git checkout -b YOUR-BRANCH-NAME
   ```

</div>

## 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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit this file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.

## 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.

<div class="ghd-tool cli">

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

</div>

<div class="ghd-tool webui">

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.

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

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

</div>

## 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.

<div class="ghd-tool webui">

1. En la página principal del repositorio, haga clic en **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="The pull request icon" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg> Solicitudes de incorporación de cambios** y, a continuación, haga clic en **Nueva solicitud de incorporación de cambios**.
2. Para la rama **base** , es probable que ya esté seleccionada la rama principal y normalmente sea la rama base en la que se combinará.
3. En la rama **de comparación** , seleccione la rama que contiene los cambios.
4. Haga clic en **Crear solicitud de incorporación de cambios**.
5. Escriba un título y una descripción que explique lo que ha cambiado y por qué.
6. 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**.

</div>

<div class="ghd-tool cli">

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:

  ```shell
  gh pr create
  ```

* Para compartir un trabajo en curso

  ```shell
  gh pr create --draft
  ```

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

</div>

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.

> \[!TIP]
> Los distintos repositorios pueden tener requisitos diferentes para la combinación. Revise las instrucciones pertinentes y siga sus instrucciones.

<div class="ghd-tool webui">

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

</div>

<div class="ghd-tool cli">

```shell
gh pr merge
```

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

</div>

## 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](/es/pull-requests/get-started/reviewing-pull-requests-quickstart).

## Lectura adicional

* [Writing code for a project](/es/pull-requests/concepts/writing-code-for-a-project)
* [Solicitudes de incorporación de cambios](/es/pull-requests/reference/pull-requests)