Problemas de GitHub

Si eres propietario de la organización, puedes aprobar Jamdesk de inmediato:

1. Haz clic en grant Jamdesk access on GitHub debajo del selector de organización (o ve a GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. En Organization access, haz clic en Grant junto a tu organización
3. De vuelta en el flujo de configuración de Jamdesk, haz clic en refresh the list. Tu organización aparece de inmediato

Si eres miembro (no propietario), verás en su lugar un botón Request; al hacer clic se envía una solicitud de aprobación a los administradores de tu organización.

Si eres miembro sin derechos de propietario, envía primero una solicitud de aprobación a tus administradores:

1. Ve a GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. En Organization access, haz clic en Request junto a tu organización. Esto notifica a los administradores de tu organización
3. Un administrador lo aprueba en Settings → Third-party access → OAuth application policy de la organización (las solicitudes pendientes muestran un botón Approve)
4. Vuelve al flujo de configuración de Jamdesk y haz clic en refresh the list; tu organización debería aparecer ahora

Consulta la guía de GitHub sobre cómo aprobar aplicaciones OAuth para tu organización para conocer los pasos detallados.

¿No quieres esperar la aprobación de un administrador? Elige tu cuenta personal durante la configuración y transfiere el repositorio a tu organización después:

1. Completa la configuración de Jamdesk con tu cuenta personal
2. Ve al repositorio creado en GitHub
3. Ve a Settings → General → Danger Zone
4. Haz clic en Transfer y selecciona tu organización como destino
5. En Jamdesk, desconecta y vuelve a conectar el repositorio desde la página Settings de tu proyecto

Esto no funciona si tu empresa gestiona tu cuenta de GitHub. Consulta en su lugar cuentas de GitHub gestionadas por la empresa.

1. Pide a un propietario de la empresa que cree una organización desde la pestaña Organizations de tu empresa. Pídele que te permita crear repositorios en ella.
2. Transfiere tu repositorio de documentación a ella. En el repositorio, ve a Settings, haz clic en Transfer en la parte inferior y elige la nueva organización.
3. En Jamdesk, haz clic en Connect an existing repository (o Install GitHub App en la configuración del proyecto). En GitHub, elige la organización, selecciona Only select repositories, elige tu repositorio e instala.

Si GitHub muestra Request en lugar de Install, un propietario de la organización recibe un correo para aprobarlo. Haz clic de nuevo en el botón de Jamdesk una vez que lo haga.

Usa esta opción si tu empresa no puede añadir una organización. Consulta primero con tu administrador de GitHub, ya que la documentación quedará fuera del GitHub de tu empresa.

1. En una ventana de navegación privada, inicia sesión en GitHub con una cuenta personal (o crea una).
2. Crea un repositorio privado vacío en esa cuenta.
3. Sube una copia de tu documentación a él. GitHub no puede transferir repositorios fuera de una empresa gestionada, así que se necesita una copia.

git remote set-url origin https://jsmith@github.com/jsmith/product-docs.git
git push -u origin main

Mantén jsmith@ en la URL para que Git te pida las credenciales de tu cuenta personal.

4. En Jamdesk, haz clic en Connect an existing repository (o Install GitHub App en la configuración del proyecto), instala Jamdesk en tu cuenta personal y elige el repositorio.

Las cuentas gestionadas no pueden hacer push a repositorios fuera de tu empresa, así que todos los que editen la documentación necesitan una cuenta personal de GitHub. Añádelos al repositorio como colaboradores.

1. Ve a GitHub → Settings → Applications → Jamdesk
2. Verifica que el repositorio tenga el acceso concedido
3. Haz clic en Configure para añadir más repositorios

Para repositorios de organización:

1. Un administrador de la organización debe aprobar Jamdesk
2. Ve a la configuración de la organización → Third-party access
3. Aprueba la solicitud de acceso de Jamdesk

Los repositorios privados requieren autorización de GitHub. Vuelve a autorizar Jamdesk si es necesario.