GitHub-Probleme

Jamdesk sofort genehmigen:

1. Klicke unter der Organisationsauswahl auf grant Jamdesk access on GitHub (oder gehe zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. Klicke unter Organization access neben deiner Organisation auf Grant
3. Klicke im Jamdesk-Setup-Ablauf auf refresh the list. Deine Organisation erscheint sofort

Mitglieder (keine Inhaber) sehen stattdessen eine Schaltfläche Request. Sie sendet eine Genehmigungsanfrage an deine Organisationsadministratoren.

Sende deinen Administratoren eine Genehmigungsanfrage:

1. Gehe zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. Klicke unter Organization access neben deiner Organisation auf Request. Dadurch werden deine Organisationsadministratoren benachrichtigt
3. Ein Administrator genehmigt die Anfrage unter Settings → Third-party access → OAuth application policy der Organisation (ausstehende Anfragen zeigen eine Schaltfläche Approve)
4. Kehre zum Jamdesk-Setup-Ablauf zurück und klicke auf refresh the list. Deine Organisation sollte nun erscheinen

Ausführliche Schritte findest du im GitHub-Leitfaden zu Genehmigung von OAuth-Apps für deine Organisation.

Wähle während des Setups dein persönliches Konto, um die Administratorgenehmigung zu überspringen. Übertrage das Repository anschließend in deine Organisation:

1. Schließe das Jamdesk-Setup mit deinem persönlichen Konto ab
2. Öffne das erstellte Repository auf GitHub
3. Öffne Settings → General → Danger Zone
4. Klicke auf Transfer und wähle deine Organisation als Ziel
5. Trenne in Jamdesk die Verbindung zum Repository auf der Seite Settings deines Projekts und verbinde es erneut

Das funktioniert nicht, wenn dein Unternehmen dein GitHub-Konto verwaltet. Siehe stattdessen firmenverwaltete GitHub-Konten.

1. Bitte einen Enterprise-Inhaber, eine Organisation zu erstellen über den Tab Organizations deines Enterprise. Bitte ihn, dir das Erstellen von Repos darin zu erlauben.
2. Übertrage dein Docs-Repository in diese Organisation. Gehe im Repo zu Settings, klicke unten auf Transfer und wähle die neue Organisation.
3. Klicke in Jamdesk auf Connect an existing repository (oder Install GitHub App in den Projekteinstellungen). Wähle bei GitHub die Organisation, wähle Only select repositories, wähle dein Repo aus und installiere.

Wenn GitHub Request statt Install anzeigt, erhält ein Organisationsinhaber eine E-Mail zur Genehmigung. Klicke nach der Genehmigung erneut auf die Jamdesk-Schaltfläche.

Nutze das, wenn dein Unternehmen keine Organisation hinzufügen kann. Kläre das vorher mit deinem GitHub-Administrator. Die Dokumentation liegt dann außerhalb des GitHub-Accounts deines Unternehmens.

1. Melde dich in einem privaten Browserfenster mit einem persönlichen Konto bei GitHub an (oder erstelle eines).
2. Erstelle darauf ein leeres privates Repo.
3. Lade eine Kopie deiner Dokumentation hinein. GitHub kann Repos nicht aus einem verwalteten Enterprise heraus übertragen.

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

Behalte jsmith@ in der URL, damit Git nach dem Login deines persönlichen Kontos fragt.

4. Klicke in Jamdesk auf Connect an existing repository (oder Install GitHub App in den Projekteinstellungen), installiere Jamdesk auf deinem persönlichen Konto und wähle das Repo aus.

Verwaltete Konten können nicht in Repos außerhalb deines Enterprise pushen. Jeder Docs-Editor braucht ein persönliches GitHub-Konto. Füge sie dem Repo als Mitarbeiter hinzu.

1. Gehe zu GitHub → Settings → Applications → Jamdesk
2. Prüfe, ob dem Repository Zugriff gewährt wurde
3. Klicke auf Configure, um weitere Repositories hinzuzufügen

Für Organisations-Repos:

1. Ein Organisationsadministrator muss Jamdesk genehmigen
2. Gehe zu den Organisationseinstellungen → Third-party access
3. Genehmige die Zugriffsanfrage für Jamdesk

Private Repos erfordern eine GitHub-Autorisierung. Autorisiere Jamdesk bei Bedarf erneut.