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 geht es um Probleme und Diskussionen. Dies sind Features, die zur gemeinsamen Natur der GitHub Enterprise Platform beitragen.

Probleme

GitHub-Probleme werden verwendet, 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.

Diese Anleitung beschreibt, wie Sie in einem Repository ein Issue erstellen. Probleme können auch aus folgenden Themen erstellt werden:

• Ein Element in einer Aufgabenliste.
• Eine Notiz in einem Projekt.
• Ein Kommentar in einem Issue oder Pull Request.
• Eine bestimmte Codezeile.
• Einer URL-Abfrage

Ein Issue in einem Repository erstellen

1. Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys.

2. Klicken Sie unter dem Repositorynamen auf Issues.

   

3. Wählen Sie Neues Issue aus. Dadurch sollte ein leeres Problemfeld geöffnet werden, das Sie ausfüllen können.

4. Wenn Ihr Repository Issue-Vorlagen verwendet, sollte Ihnen eine Liste der Issue-Typen angezeigt werden, aus der Sie den Typ auswählen können, den Sie verwenden möchten.

   Wenn der Typ des Problems, das Sie öffnen möchten, nicht in den verfügbaren Optionen enthalten ist, wählen Sie "Leeres Problem" aus. Wenn Sie keine Vorlagen verwenden, fahren Sie mit Schritt 5 fort.

   Wenn Ihr Repository Issue-Formulare verwendet, sehen Sie statt einer leeren Issue-Vorlage ein strukturiertes Formular zum Ausfüllen. Issue-Formulare ermöglichen es Maintainern, bestimmte Informationen in einem standardisierten Format zu sammeln.

   

5. Geben Sie im Feld Titel hinzufügen einen Titel für Ihr Issue ein.

6. Geben Sie im Feld Beschreibung hinzufügen eine Beschreibung für Ihr Issue ein.

7. Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden.

8. Wählen Sie abschließend Neues Issue übermitteln aus.

Verwenden Sie Bezeichnungen, Erwähnungen und Reaktionen, um die Zusammenarbeit effektiv zu verwalten und die Sichtbarkeit von Themen zu erhöhen. Problemvorlagen helfen dabei, konsistente Struktur und Erwartungen für Mitwirkende aufrechtzuerhalten.

Einige Unterhaltungen sind möglicherweise für GitHub-Diskussionen besser geeignet. Verwenden Sie GitHub-Diskussionen, um Fragen zu stellen und zu beantworten, Informationen freizugeben, Ankündigungen zu machen und an Unterhaltungen über ein Projekt teilzunehmen oder daran teilzunehmen.

Im nächsten Abschnitt werden Diskussionen und die optimale Nutzung des Features erläutert.

Diskussionen

Diskussionen sind für Unterhaltungen konzipiert, die nicht unbedingt an Code gebunden sind – z. B. F&A, Ideen oder allgemeines Feedback. Sie unterstützen die offene, fortlaufende Kommunikation innerhalb eines freigegebenen Forums und können je nach Sichtbarkeit des Repositorys öffentlich oder privat sein.

In diesem Abschnitt erfahren Sie, wie Sie:

• 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 und Besitzer mit Schreibzugriff können GitHub-Diskussionen für eine Community in ihren öffentlichen und privaten Repositorys aktivieren. Die Sichtbarkeit einer Diskussion übernimmt ihre Sichtbarkeit von dem Repository, in dem sie erstellt wurde.

Wenn Sie GitHub-Diskussionen zum ersten Mal aktivieren, werden Sie aufgefordert, einen Willkommensbeitrag zu konfigurieren.

1. Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys.

2. Wählen Sie unter dem Namen Ihres Repositorys settings.

   

3. Scrollen Sie nach unten zum Abschnitt Features, und wählen Sie unter Diskussionen die Option Setupdiskussionen aus.

   

4. Unter „Neue Diskussion beginnen“ können Sie die Vorlage so bearbeiten, dass sie zum Ton und zu den Ressourcen Ihrer Community passt.

5. 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. Für Diskussionen auf Organisationsebene kann jeder Benutzer, der das Quell-Repository anzeigen kann, auch eine Diskussion erstellen.

1. Navigieren Sie auf GitHub.com zur Hauptseite des Repositorys oder der Organisation, zu dem bzw. der Sie eine Diskussion starten möchten.

2. Wählen Sie unter dem Namen Ihres Repositorys oder Ihrer Organisation Diskussionen aus.

   

3. Wählen Sie auf der rechten Seite der Seite Neue Diskussion aus.

4. Wählen Sie eine Diskussionskategorie aus, indem Sie " Erste Schritte" auswählen. Alle Diskussionen müssen in einer Kategorie platziert werden. Repository-Betreuer definieren diese Kategorien.

   

Jede Diskussionskategorie enthält einen eindeutigen Namen, Emoji und eine Beschreibung, um ihren Zweck zu verdeutlichen. 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.

Repository-Verwalter können wichtige Diskussionen oben im Tab „Diskussionen“ anheften, um sie besser sichtbar zu machen.

1. Geben Sie unter Diskussionstitel einen Titel für Ihre Diskussion ein, und geben Sie unter Schreiben den Text Ihrer Diskussion ein.

   

2. Wählen Sie Diskussion starten aus.

Dies deckt ab, wie GitHub die Zusammenarbeit über Probleme und Diskussionen unterstützt. Als Nächstes lernen Sie, wie Sie Benachrichtigungen verwalten, Threads abonnieren und GitHub-Seiten verwenden.

Markieren eines Kommentars als Antwort

In einer F&A-Diskussion können Sie einen Kommentar als akzeptierte Antwort auf die ursprüngliche Frage markieren.

1. Navigieren Sie zur Diskussion.
2. Suchen Sie den Kommentar, der die ursprüngliche Frage am besten beantwortet.
3. Wählen Sie unter dem Kommentar " Als Antwort markieren " aus.

Der Kommentar wird hervorgehoben, sodass andere Benutzer die Lösung schnell finden können. Sie können bei Bedarf auch die Markierung einer Antwort aufheben.

Verweisen auf eine Diskussion in einem Problem

Wenn eine Diskussion zu Einer Arbeit führt, die nachverfolgt werden muss, können Sie die Diskussion in ein Problem umwandeln.

1. Navigieren Sie zu der Diskussion, die Sie konvertieren möchten.
2. Wählen Sie oben rechts in der Diskussion das ... Menü (drei Punkte) aus.
3. Wählen Sie In neuem Issue darauf verweisen aus.
4. Bestätigen Sie den neuen Issue-Titel und die Beschreibung.

Dies erfasst umsetzbare Aufgaben, die aus Diskussionen in der Community hervorgehen.

Anheften einer Diskussion

Sie können wichtige Diskussionen oben auf der Diskussionsseite anheften, um für mehr Sichtbarkeit zu sorgen.

1. Navigieren Sie zu der Diskussion, die Sie anheften möchten.
2. Wählen Sie oben rechts in der Diskussion das ... Menü (drei Punkte) aus.
3. Wählen Sie Diskussion anheften aus.

Angeheftete Diskussionen eignen sich gut, um Ankündigungen, wichtige Fragen oder aktuelle Themen hervorzuheben, die die Community beachten sollte.