> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-i-to-quickstart-8818.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">
  ## Instalación de 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 del repositorio de tu documentación. Debes ser propietario de la organización o tener permisos de administrador en un repositorio para instalar la aplicación. Si no tienes los permisos necesarios, el propietario del repositorio debe aprobar la solicitud de instalación.

Instala la aplicación de GitHub de Mintlify desde tu [panel de control](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/mintlify-mintlify-add-i-to-quickstart-8818/POxrbHB6_BZDU4E9/images/github/select-repos.png?fit=max&auto=format&n=POxrbHB6_BZDU4E9&q=85&s=6839d070f04c5af07a0d6abbdf92a651" width="2980" height="1702" data-path="images/github/select-repos.png" />
</Frame>

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

Cuando instalas 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 comprobaciones de estado en las pull requests
* `code`: Leer los cambios de archivos cuando haces commit en tu rama de documentación
* `deployments`: Generar despliegues de vista previa para pull requests
* `pull requests`: Crear ramas y pull requests desde el editor web
* `workflows`: Administrar GitHub Actions para los despliegues de documentación

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

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

Al instalar nuestra aplicación de GitHub, puedes conceder acceso a todos tus repositorios o solo a algunos específicos. Recomendamos conceder acceso únicamente a los repositorios donde está 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 origen de la documentación
</div>

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

<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="Reinstala la aplicación de Mintlify.">
    1. En tu panel 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 panel.
  </Step>
</Steps>

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

Si no puedes habilitar las opciones de sugerencias de edición o de informar problemas en tu panel 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 panel.
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-i-to-quickstart-8818/POxrbHB6_BZDU4E9/images/github/revalidate-settings-light.png?fit=max&auto=format&n=POxrbHB6_BZDU4E9&q=85&s=f3de52c9cd37e8915cf339526650a07c" alt="La página de Git Settings en el panel 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/mintlify-mintlify-add-i-to-quickstart-8818/POxrbHB6_BZDU4E9/images/github/revalidate-settings-dark.png?fit=max&auto=format&n=POxrbHB6_BZDU4E9&q=85&s=844baba43bcf1b30701d65c2e2144a8a" alt="La página de Git Settings en el panel 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>