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

# GitHub

> Sincroniza tu documentación con un repositorio de GitHub

Mintlify utiliza una Aplicación de GitHub para sincronizar automáticamente tu documentación con tu repositorio de GitHub.

<div id="installing-the-github-app">
  ## Instalar la Aplicación de GitHub
</div>

Instala la Aplicación de GitHub de Mintlify en la cuenta u organización de GitHub que sea propietaria de tu repositorio de documentación. Debes ser propietario de la organización o tener permisos de administrador en el repositorio para instalar la aplicación. Si no cuentas con los permisos necesarios, el propietario del repositorio deberá aprobar la solicitud de instalación.

Instala la Aplicación de GitHub de Mintlify desde tu [dashboard](https://dashboard.mintlify.com/settings/organization/github-app).

<Tip>
  Recomendamos otorgar acceso solo al repositorio donde se aloja tu documentación.
</Tip>

<Frame>
  <img className="h-80" alt="Página de instalación de la Aplicación de GitHub de Mintlify con la opción «Only select repositories» seleccionada." src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/github/select-repos.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=0aa6291d0b390f385e9f04dac9ec7218" width="2980" height="1702" data-path="images/github/select-repos.png" />
</Frame>

<div id="permissions">
  ## Permisos
</div>

Cuando instales la Aplicación de GitHub, se te pedirá que concedas los siguientes permisos:

Permisos de lectura:

* `metadata`: Información básica del repositorio

Permisos de lectura y escritura:

* `checks`: Crear verificaciones de estado en solicitudes de extracción
* `code`: Leer cambios de archivos cuando confirmes en tu branch de documentación
* `deployments`: Generar implementaciones de vista previa para solicitudes de extracción
* `pull requests`: Crear branches y solicitudes de extracción desde el editor web
* `workflows`: Administrar GitHub Actions para implementaciones de la documentación

<Info>
  La aplicación solo accede a los repositorios a los que le otorgues acceso explícitamente. Si tienes habilitadas reglas de protección de branch, la aplicación no puede hacer push directamente a branches protegidas.
</Info>

<div id="managing-repository-access">
  ## Gestión del acceso a repositorios
</div>

Al instalar nuestra Aplicación de GitHub, puedes otorgar acceso a todos tus repositorios o solo a algunos específicos. Recomendamos otorgar acceso únicamente a los repositorios donde se aloja tu documentación. Puedes modificar esta selección en cualquier momento en la [configuración de la aplicación de GitHub](https://github.com/apps/mintlify/installations/new).

<div id="configuring-docs-source">
  ## Configurar el source de la documentación
</div>

Cambia la organización, el repositorio o la branch desde la que se genera tu documentación en la sección [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) de tu dashboard.

<div id="troubleshooting">
  ## Resolución de problemas
</div>

<div id="github-app-connection-issues">
  ### Problemas de conexión con la Aplicación de GitHub
</div>

Si tienes problemas con la Aplicación de GitHub, restablecer la conexión puede resolver la mayoría de los casos.

<Steps>
  <Step title="Desinstala la aplicación de Mintlify desde GitHub.">
    1. En GitHub, ve a [installations](https://github.com/settings/installations) y selecciona **Configure** junto a la aplicación de Mintlify. Desplázate hacia abajo y selecciona **Uninstall**.
    2. Ve a [Authorized GitHub Apps](https://github.com/settings/apps/authorizations) y selecciona **Revoke** junto a la aplicación de Mintlify.
  </Step>

  <Step title="Vuelve a instalar la aplicación de Mintlify.">
    1. En tu Dashboard de Mintlify, ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) e instala la Aplicación de GitHub.
    2. Autoriza tu cuenta en la sección [My Profile](https://dashboard.mintlify.com/settings/account) de tu dashboard.
  </Step>
</Steps>

<div id="feedback-add-ons-are-unavailable">
  ### Los add-ons de comentarios no están disponibles
</div>

Si no puedes habilitar las opciones de sugerencias de edición o crear issues en tu dashboard y tu repositorio es público, vuelve a validar tu configuración de Git.

<Steps>
  <Step title="Ve a Git Settings">
    Ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) en tu dashboard.
  </Step>

  <Step title="Vuelve a validar tu configuración">
    Haz clic en la marca de verificación verde en la esquina del recuadro de Git Settings para volver a validar la configuración de tu repositorio. Esto forzará la actualización para reflejar si tu repositorio es público o privado.

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/github/revalidate-settings-light.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=c07c2b05c162d715732b5f5f81b64ada" alt="La página de Git Settings en el Dashboard de Mintlify. Una flecha naranja apunta a la marca de verificación verde que vuelve a validar la configuración del repositorio." className="block dark:hidden" width="1996" height="1168" data-path="images/github/revalidate-settings-light.png" />

      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/github/revalidate-settings-dark.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=d30218ba177bd1967e0f9c56698df761" alt="La página de Git Settings en el Dashboard de Mintlify. Una flecha naranja apunta a la marca de verificación verde que vuelve a validar la configuración del repositorio." className="hidden dark:block" width="1998" height="1170" data-path="images/github/revalidate-settings-dark.png" />
    </Frame>
  </Step>
</Steps>