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

Propón tu primer cambio y sigue todo el proceso, desde tu primera confirmación hasta una solicitud de extracción 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. 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.

<div class="ghd-tool webui">

1. En GitHub, vaya a la página principal del repositorio para el que desea proponer cambios.
2. 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.
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/enterprise-cloud@latest/github-cli/github-cli/quickstart).

2. 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:

  ```shell
  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.

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

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

<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 realizar un commit, introducirás un mensaje de commit y lo enviarás directamente a 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**.

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

</div>

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

<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 main ya esté seleccionada y, por lo general, es la rama base en la que realizarás la fusión.
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, utiliza el menú desplegable y selecciona **Crear solicitud de incorporación de cambios (borrador)**.

</div>

<div class="ghd-tool cli">

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:

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

> \[!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/enterprise-cloud@latest/pull-requests/get-started/reviewing-pull-requests-quickstart).

## Lectura adicional

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