Ferndesk
Integraciones

Integración de GitHub

Conecta tu cuenta de GitHub a Ferndesk para que Fern pueda explorar tu base de código y entender cómo funcionan las funciones, lo que ayuda a generar artículos del centro de ayuda más precisos y relevantes.

Necesitas una cuenta de GitHub para completar esta integración. Si no tienes una, crea una en el sitio web de GitHub.

Conectar GitHub

  1. Desde tu panel de Ferndesk, haz clic en Integraciones en la barra lateral.

    Página de Integraciones que muestra la cuadrícula de tarjetas de integración disponibles
  2. Busca la tarjeta de GitHub y haz clic en Conectar.

    Tarjeta de integración de GitHub con el botón Conectar resaltado
  3. Se te redirigirá a GitHub para autorizar la conexión. Inicia sesión en tu cuenta de GitHub si aún no lo has hecho.

  4. Concede a Ferndesk permiso para acceder a tu cuenta de GitHub. Puedes seleccionar qué repositorios conectar. Puedes elegir varios repositorios si tu proyecto abarca varios repositorios, como un backend y un panel en repositorios separados.

  5. Después de autorizar, se te redirigirá de vuelta a Ferndesk. La integración de GitHub aparecerá como conectada.

Una vez conectado, Fern puede explorar tu base de código para ofrecer artículos del centro de ayuda más precisos y relevantes.

Administrar repositorios conectados

Después de la configuración inicial, puedes agregar o quitar repositorios visitando la configuración de tu aplicación de GitHub. Ve a la configuración de tu cuenta de GitHub, navega a Applications y busca Ferndesk en tus integraciones instaladas para ajustar el acceso a los repositorios.

Alcance de repositorio y rama

Cuando Fern explora tu base de código, puede apuntar a un repositorio o rama específicos de tu cuenta de GitHub conectada en lugar de depender solo del repositorio predeterminado.

Si tienes varios repositorios conectados, Fern puede centrarse en el repositorio relevante durante el análisis. Para trabajos específicos de una rama, como revisar una función que aún no se ha lanzado o un pull request, Fern también puede explorar una rama específica cuando se proporciona una.

Para permitir que Fern explore un repositorio, asegúrate de que esté conectado en tu integración de GitHub. Ve a la configuración de tu cuenta de GitHub, navega a Applications y busca Ferndesk para agregar o quitar el acceso al repositorio.

Solución de problemas

Veo "Se requiere autenticación para conectar GitHub"

Debes iniciar sesión en tu espacio de trabajo de Ferndesk antes de conectar una integración. Asegúrate de que has iniciado sesión y de que estás en la organización correcta. Si tienes acceso a varios espacios de trabajo de Ferndesk, cambia al que quieras añadir la conexión de GitHub.

Veo "La organización OAuth de GitHub no coincide con la sesión activa"

La cuenta o la organización de GitHub que estás autorizando pertenece a una organización distinta de aquella en la que has iniciado sesión en Ferndesk. Asegúrate de:

  • Has iniciado sesión en el espacio de trabajo correcto de Ferndesk

  • Estás autorizando la cuenta o la organización de GitHub que corresponde a esa organización de Ferndesk

Si necesitas conectar una organización distinta de GitHub a otro espacio de trabajo de Ferndesk, cambia primero a ese espacio de trabajo en Ferndesk y luego conecta GitHub.

La página de autorización de GitHub muestra un error

Esto puede ocurrir si:

  • Tu sesión caducó. Intenta cerrar sesión en Ferndesk y volver a iniciarla.

  • El estado OAuth se volvió inválido. Cierra la ventana de autorización y vuelve a hacer clic en Conectar en Ferndesk.

Recursos adicionales

Para obtener más información sobre las funciones de GitHub, visita la Documentación de GitHub.

¿Te fue útil?