GitHub: eine kollaborative Plattform
Die Zusammenarbeit steht im Mittelpunkt aller Aufgaben von GitHub. Wir haben Repositorys in der ersten Lerneinheit des Moduls behandelt und gelernt, dass diese Ihnen helfen, Ihr Projekt und dessen Dateien zu organisieren. In der letzten Lerneinheit, haben Sie Pull Requests kennengelernt, die eine Möglichkeit zum Nachverfolgen von Änderungen an Ihrem Projekt darstellen.
In dieser Lerneinheit lernen Sie Issues und Diskussionen kennen. Dies sind zwei weitere Aspekte der Zusammenarbeit auf der GitHub Enterprise-Plattform.
Probleme
GitHub-Issues wurden entwickelt, um Ideen, Feedback, Aufgaben oder Fehler für die Arbeit auf GitHub nachzuverfolgen. Issues können auf verschiedene Arten erstellt werden, sodass Sie die bequemste Methode für Ihren Workflow auswählen können.
In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie ein Issue aus einem Repository erstellen. Issues können jedoch auch aus Folgendem erstellt werden:
- Einem Element in einer Aufgabenliste
- Einer Notiz in einem Projekt
- Einem Kommentar in einem Issue oder Pull Request
- Einer bestimmten Codezeile
- Einer URL-Abfrage
Erstellen eines Issues aus einem Repository
Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys.
Klicken Sie unter dem Repositorynamen auf Issues.
Wählen Sie Neues Issue aus.
Wenn Ihr Repository Issuevorlagen verwendet, wählen Sie neben dem zu erstellenden Issuetyp Erste Schritte aus.
Wenn die Art des Issues, das Sie öffnen möchten, nicht in den verfügbaren Optionen enthalten ist, wählen Sie Leeres Issue öffnen aus. Wenn Sie keine Vorlagen verwenden, fahren Sie mit Schritt 5 fort.
Geben Sie im Feld Titel hinzufügen einen Titel für Ihr Issue ein.
Geben Sie im Feld Beschreibung hinzufügen eine Beschreibung für Ihr Issue ein.
Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden.
Wählen Sie abschließend Neues Issue übermitteln aus.
Einige Unterhaltungen eignen sich besser für GitHub-Diskussionen. Sie können GitHub-Diskussionen verwenden, um Fragen zu stellen und zu beantworten, Informationen zu teilen, Ankündigungen zu machen und sich an Unterhaltungen über ein Projekt zu beteiligen.
Im nächsten Abschnitt werden Diskussionen und die optimale Nutzung des Features erläutert.
Diskussionen
Diskussionen sind für Unterhaltungen vorgesehen, die für alle zugänglich sein müssen und sich nicht auf Code beziehen. Discussions ermöglicht lockere, offene Gespräche in einem öffentlichen Forum.
In diesem Abschnitt wird Folgendes behandelt:
- Einrichten einer Diskussion in Ihrem Repository
- Erstellen einer neuen Diskussion und verschiedener Diskussionskategorien
Wir fahren mit der Einrichtung einer Diskussion in Ihrem Repository fort.
Einrichten einer Diskussion in Ihrem Repository
Repositorybesitzer*innen und Personen mit Schreibzugriff können GitHub-Diskussionen für die Community in ihren öffentlichen und privaten Repositorys aktivieren. Die Sichtbarkeit einer Unterhaltung wird von dem Repository geerbt, in dem die Unterhaltung erstellt wurde.
Wenn Sie GitHub-Diskussionen zum ersten Mal aktivieren, werden Sie eingeladen, einen Willkommensbeitrag zu erstellen.
Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys.
Wählen Sie unter dem Namen Ihres Repositorys settings.
Scrollen Sie nach unten zum Abschnitt Features, und wählen Sie unter Diskussionen die Option Setupdiskussionen aus.
Passen Sie unter Neue Diskussion starten die Vorlage an die Ressourcen und den Umgangston an, die Sie für Ihre Community festlegen möchten.
Wählen Sie Diskussion starten aus.
Sie können jetzt eine neue Diskussion erstellen.
Erstellen einer neuen Diskussion
Jeder authentifizierte Benutzer mit Anzeigeberechtigungen für das Repository kann eine Diskussion in diesem Repository erstellen. Und da Organisationsdiskussionen auf einem Quellrepository basieren, kann jeder authentifizierte Benutzer, der das Quellrepository anzeigen kann, eine Diskussion in dieser Organisation erstellen.
Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys oder der Organisation, zu dem bzw. der Sie eine Diskussion starten möchten.
Wählen Sie unter dem Namen Ihres Repositorys oder Ihrer Organisation Diskussionen aus.
Wählen Sie auf der rechten Seite der Seite Neue Diskussion aus.
Wählen Sie eine Diskussionskategorie aus, indem Sie Erste Schritte auswählen. Alle Diskussionen müssen in einer Kategorie erstellt werden. Für Repositorydiskussionen legen Personen mit Betreuer- oder Administratorberechtigung für das Repository die Kategorien für Diskussionen im jeweiligen Repository fest.
Jede Kategorie muss über einen eindeutigen Namen, ein Emoji und eine detaillierte Beschreibung verfügen, die den Zweck angibt. Mithilfe von Kategorien können Betreuer organisieren, wie Unterhaltungen gespeichert werden. Sie sind anpassbar, um Kategorien zu unterscheiden, die Fragen und Antworten oder eher offene Unterhaltungen darstellen. In der folgenden Tabelle sind die Standardkategorien für Diskussionen und deren Zweck aufgeführt.
| Kategorie | Zweck | Format |
|---|---|---|
| 📣 Ankündigungen | Updates und Neuigkeiten von Projektverwalter*innen | Ankündigung |
| #️⃣ Allgemein | Für das Projekt relevante Inhalte | Offene Diskussionen |
| 💡 Ideen | Ideen zum Ändern oder Verbessern des Projekts | Offene Diskussionen |
| 🗳️ Polls | Umfragen mit mehreren Auswahlmöglichkeiten für die Community, die diskutiert werden können | Umfragen |
| 🙏 Q&A | Fragen an die Community im Frage-Antwort-Format | Fragen und Antworten |
| 🙌 Anzeigen und Teilen | Erstellte Inhalte, Experimente oder Tests, die für das Projekt relevant sind | Offene Diskussionen |
Geben Sie unter Diskussionstitel einen Titel für Ihre Diskussion ein, und geben Sie unter Schreiben den Text Ihrer Diskussion ein.
Wählen Sie Diskussion starten aus.
Damit haben Sie einen ersten Eindruck davon, wie GitHub die Zusammenarbeit unterstützt. Als Nächstes lernen Sie, wie Sie Benachrichtigungen verwalten, Threads abonnieren und GitHub-Seiten verwenden.