> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Conecta un repositorio de GitHub para implementaciones automatizadas, vistas previas de solicitudes de extracción y sincronización continua.

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

<Tip>
  **¿Necesitas la Aplicación de GitHub?**

  * **Repositorio alojado en Mintlify** en la organización `mintlify-community`: No. La Aplicación de GitHub ya está configurada.
  * **Tu propio repositorio**: Sí. Instala la Aplicación de GitHub para habilitar implementaciones automáticas cuando envíes cambios.

  Consulta tu repositorio en la página [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) de tu dashboard.
</Tip>

Si tu repositorio es privado y pertenece a la organización Mintlify, la Aplicación de GitHub está configurada y gestionada automáticamente por Mintlify. Puedes usar el editor web para realizar cambios en tu documentación. Si quieres trabajar en tu documentación de forma local, clona el repositorio en tu propia organización y actualiza tu configuración de Git para usar tu propio repositorio.

<div id="clone-to-your-own-repository">
  ## Clona en tu propio repositorio
</div>

Si omitiste conectar tu propio repositorio de Git durante la configuración inicial, tu documentación se encuentra en un repositorio privado propiedad de la organización Mintlify. Para moverla a tu propia cuenta u organización:

1. Ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) en tu dashboard.
2. Haz clic en **Clone as Private** o **Clone as Public**. Los repos públicos permiten que cualquier persona vea el código fuente de tu documentación y envíe issues o sugerencias. Los repos privados restringen el acceso a tu equipo.
3. Instala la Aplicación de GitHub siguiendo los pasos en [Install the GitHub App](#install-the-github-app) a continuación.

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

<Note>
  Debes ser propietario de la organización o tener permisos de administrador en un repositorio para instalar la aplicación. Si no cuentas con los permisos necesarios, el propietario del repositorio debe aprobar la solicitud de instalación.
</Note>

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/anotherhorizon/JcCuRMYxa7xgY0h0/images/github/select-repos.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=9749ad2f2d5af92c615be6ccd820faa5" width="2980" height="1702" data-path="images/github/select-repos.png" />
</Frame>

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

Cuando instales la Aplicación de GitHub, concede 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 en archivos cuando haces una confirmación 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

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

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

Al instalar la Aplicación de GitHub, puedes conceder acceso a todos tus repositorios o solo a algunos específicos. Recomendamos conceder acceso únicamente a tu repositorio de documentación y a cualquier otro repositorio que quieras proporcionar como contexto para el agente. 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="configure-docs-source">
  ## Configurar la fuente de la documentación
</div>

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

<div id="github-enterprise-with-ip-allowlists">
  ## GitHub Enterprise con listas de IP permitidas
</div>

Si tu organización de GitHub Enterprise Cloud tiene habilitada una lista de IP permitidas, debes agregar la dirección IP saliente de Mintlify (`54.242.90.151`) a tu lista para que la Aplicación de GitHub funcione correctamente.

Sigue la [documentación de GitHub](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization) para configurar tu lista de IP permitidas.

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

<div id="deployment-not-triggering-automatically">
  ### La implementación no se activa automáticamente
</div>

Si los pushes a tu repositorio no desencadenan implementaciones, revisa los siguientes posibles problemas.

<AccordionGroup>
  <Accordion title="Verificar la instalación de la Aplicación de GitHub">
    Comprueba que la aplicación esté instalada en el repositorio correcto.

    1. Ve a la [configuración de la Aplicación de GitHub](https://dashboard.mintlify.com/settings/organization/github-app) en tu dashboard.
    2. Verifica que tu repositorio esté en la lista de instalaciones activas de la aplicación.
  </Accordion>

  <Accordion title="Comprobar la rama de implementación">
    Asegúrate de que estás haciendo push a la rama correcta.

    1. Ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings)
    2. Verifica que la rama en tu dashboard coincida con la rama a la que estás haciendo push.
  </Accordion>
</AccordionGroup>

<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 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 complementos de comentarios no están disponibles
</div>

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

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

  <Step title="Volver a validar la 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 para reflejar si tu repositorio es público o privado.

    <Frame>
      <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/github/revalidate-settings-light.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=d152ce0a8d5ce5c53a4b02df40a7c2e9" 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/github/revalidate-settings-dark.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=5ecb99047442854642a33e7b7f564481" 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>