Problemi GitHub

Approva subito Jamdesk:

1. Fai clic su concedi l'accesso a Jamdesk su GitHub sotto il selettore delle organizzazioni (oppure vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. In Organization access, fai clic su Grant accanto alla tua organizzazione
3. Torna al flusso di configurazione di Jamdesk e fai clic su aggiorna l'elenco. La tua organizzazione compare subito

I membri (non i proprietari) vedono invece un pulsante Request. Invia una richiesta di approvazione agli amministratori dell'organizzazione.

Invia agli amministratori una richiesta di approvazione:

1. Vai su GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. In Organization access, fai clic su Request accanto alla tua organizzazione. Questo notifica gli amministratori
3. Un amministratore la approva in Settings → Third-party access → OAuth application policy dell'organizzazione (le richieste in attesa mostrano un pulsante Approve)
4. Torna al flusso di configurazione di Jamdesk e fai clic su aggiorna l'elenco. La tua organizzazione dovrebbe ora comparire

Per i passaggi dettagliati, consulta la guida di GitHub su come approvare le app OAuth per la tua organizzazione.

Scegli il tuo account personale durante la configurazione per saltare l'approvazione dell'amministratore. Trasferisci poi il repository alla tua organizzazione:

1. Completa la configurazione di Jamdesk usando il tuo account personale
2. Vai al repository creato su GitHub
3. Apri Settings → General → Danger Zone
4. Fai clic su Transfer e seleziona la tua organizzazione come destinazione
5. In Jamdesk, scollega e ricollega il repository dalla pagina Settings del tuo progetto

Questo non funziona se il tuo account GitHub è gestito dall'azienda. Consulta invece account GitHub gestiti dall'azienda.

1. Chiedi a un proprietario dell'enterprise di creare un'organizzazione dalla scheda Organizations della tua enterprise. Chiedi che ti permetta di creare repository al suo interno.
2. Trasferisci il tuo repository della documentazione al suo interno. Nel repository, vai su Settings, fai clic su Transfer in fondo e scegli la nuova organizzazione.
3. In Jamdesk, fai clic su Connect an existing repository (oppure su Install GitHub App nelle impostazioni del progetto). Su GitHub, scegli l'organizzazione, seleziona Only select repositories, scegli il tuo repository e installa.

Se GitHub mostra Request invece di Install, un proprietario dell'organizzazione riceve un'email per approvare la richiesta. Dopo l'approvazione, fai di nuovo clic sul pulsante di Jamdesk.

Usa questa opzione quando la tua azienda non può aggiungere un'organizzazione. Verifica prima con il tuo amministratore GitHub. La documentazione sarà ospitata al di fuori del GitHub aziendale.

1. In una finestra privata del browser, accedi a GitHub con un account personale (oppure creane uno).
2. Crea un repository privato vuoto su quell'account.
3. Esegui il push di una copia della documentazione. GitHub non può trasferire repository al di fuori di un'enterprise gestita.

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

Mantieni jsmith@ nell'URL così Git chiede le credenziali del tuo account personale.

4. In Jamdesk, fai clic su Connect an existing repository (oppure su Install GitHub App nelle impostazioni del progetto), installa Jamdesk sul tuo account personale e scegli il repository.

Gli account gestiti non possono eseguire push su repository esterni alla tua enterprise. Ogni editor della documentazione ha bisogno di un account GitHub personale. Aggiungili al repository come collaboratori.

1. Vai su GitHub → Settings → Applications → Jamdesk
2. Verifica che al repository sia concesso l'accesso
3. Fai clic su Configure per aggiungere altri repository

Per i repository di organizzazione:

1. Un amministratore dell'organizzazione deve approvare Jamdesk
2. Vai alle impostazioni dell'organizzazione → Third-party access
3. Approva la richiesta di accesso di Jamdesk

I repository privati richiedono l'autorizzazione di GitHub. Riautorizza Jamdesk se necessario.