> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos básicos de Git para el editor

> Comprenda los conceptos de control de versiones de Git detrás del editor de Mintlify: branches, commits, pull requests y flujos de fusión.

Git le permite controlar y hacer seguimiento de los cambios en los archivos. Es el sistema de control de versiones detrás de los flujos de trabajo basados en branches, donde gestiona el contenido del mismo modo que cualquier otra base de código.

El editor web se encarga de las operaciones de Git por usted. Comprender algunos conceptos clave le ayuda a aprovechar al máximo el editor y a colaborar eficazmente con su equipo.

<div id="what-git-does-for-your-content">
  ## Lo que Git hace por su contenido
</div>

Git registra cada cambio realizado en su contenido. Anota qué cambió, quién lo cambió, cuándo lo cambió y por qué. Esto significa que puede:

* Ver el historial completo de cualquier página.
* Deshacer cambios revirtiendo a una versión anterior.
* Trabajar en actualizaciones sin afectar a su sitio en producción.
* Revisar los cambios antes de que se publiquen.

Su repositorio es la colección de archivos y su historial que conforman su sitio. El editor se conecta a este repositorio para sincronizar y publicar su contenido.

<div id="key-concepts">
  ## Conceptos clave
</div>

Estos son los conceptos de Git con los que se encontrará con más frecuencia al usar el editor web.

<AccordionGroup>
  <Accordion title="Commit">
    Una instantánea guardada de sus cambios en un momento específico. Cada commit incluye un mensaje que describe qué cambió y crea un registro permanente en el historial de su proyecto.

    Cuando publica cambios, el editor web crea un commit en su repositorio de Git.
  </Accordion>

  <Accordion title="Branch">
    Una línea de trabajo independiente en su repositorio. A veces se le llama **feature branch**.

    Su sitio en producción se compila desde una **deployment branch**, normalmente llamada `main`. Otras branches le permiten trabajar en cambios de forma independiente sin afectar a su sitio en producción. Nada en una branch se publica hasta que la fusiona con su deployment branch mediante una pull request.

    Cambie entre branches usando el menú desplegable de branches en la barra de herramientas del editor. Si tiene cambios sin publicar, el editor le permite llevarlos a la nueva branch o dejarlos en su branch actual.
  </Accordion>

  <Accordion title="Deployment branch">
    La branch que compila su sitio en producción, normalmente llamada `main`. Los cambios fusionados en esta branch se despliegan automáticamente en su sitio.
  </Accordion>

  <Accordion title="Pull request">
    Una propuesta para fusionar cambios de una branch en otra. Las pull requests permiten que su equipo revise y discuta los cambios antes de que se publiquen.

    Cuando publica cambios en una feature branch (o cuando su repositorio exige pull requests), el editor web crea una pull request. Su equipo revisa y fusiona la pull request en su proveedor de Git (GitHub o GitLab).
  </Accordion>

  <Accordion title="Merge">
    Combinar cambios de una branch en otra. Después de que su equipo revisa y aprueba una pull request, fusionar la branch incorpora sus cambios en la deployment branch y los publica.
  </Accordion>

  <Accordion title="Conflict">
    Ocurre cuando dos branches tienen cambios incompatibles en los mismos archivos. El editor le ayuda a resolver los conflictos cuando se producen.
  </Accordion>

  <Accordion title="Diff">
    Una comparación que muestra las diferencias entre dos versiones de un archivo. El editor muestra un diff visual de sus cambios pendientes antes de publicar para que pueda revisar exactamente lo que se va a confirmar.
  </Accordion>
</AccordionGroup>

<div id="how-the-editor-maps-to-git">
  ## Cómo se relaciona el editor con Git
</div>

Cada acción en el editor web corresponde a una operación de Git. Aquí está la referencia completa:

| Acción en el editor                       | Operación de Git                                                                                     |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Editar una página                         | Los cambios se guardan automáticamente en los servidores de Mintlify. Aún no hay commit de Git.      |
| Publicar en su deployment branch          | `git commit` y `git push`. Desencadena un despliegue.                                                |
| Save in branch                            | `git commit` en la feature branch actual.                                                            |
| Create pull request                       | `git push` y abre una pull request contra su deployment branch.                                      |
| Merge and publish                         | Fusiona la pull request y desencadena un despliegue.                                                 |
| Crear una branch                          | `git checkout -b <branch-name>`                                                                      |
| Cambiar de branch                         | `git checkout <branch-name>`                                                                         |
| Push externo o actualización desde la CLI | Los cambios entrantes se sincronizan en el editor automáticamente mediante una fusión a tres bandas. |