Erstellen von GitHub-Issues für Open-Source-Produkte

In diesem Artikel erfahren Sie, wie Sie ein GitHub-Ticket für Microsoft Learn-Dokumentationen zu Open-Source-Produkten erstellen. Außerdem lernen Sie, wie Sie die Issues anderer Benutzer durchgehen und entweder eigene Kommentare hinzufügen oder einen Pull Request (PR) öffnen, um sie zu beheben.

Unsere Dokumentationen zu Open-Source-Produkten können fortlaufend geändert und verbessert werden. Wenn wir gute GitHub-Issues von Mitwirkenden erhalten, können wir unsere Bemühungen auf die höchsten Prioritäten für die Community konzentrieren.

Wenn Sie wissen, wie Sie ein Issue beheben können, laden wir Sie ein, die Änderungen selbst vorzunehmen, anstatt ein Problem zu öffnen.

Hinweis

GitHub-Tickets werden ausschließlich von Open-Source-Produkten akzeptiert, für die die Open-Source-Feedback-Benutzungsoberfläche bereitgestellt wird. Weitere Informationen und eine Liste der beteiligten Repositorys finden Sie unter Verwenden der Open-Source-Benutzungsoberfläche. Weitere Informationen zum Bereitstellen von Nicht-GitHub-Feedback auf der Microsoft Learn-Plattform finden Sie unter Bereitstellen von Feedback auf Microsoft Learn.

Voraussetzungen

• Erstellen Sie ein GitHub-Konto, wenn Sie noch keines besitzen.

Ausgabe erstellen

1. Navigieren Sie zu dem Artikel, den Sie kommentieren möchten.

2. Scrollen Sie zum Ende des Artikels, wo die Optionen zum Einreichen von Feedback aufgeführt sind. Wählen Sie Dokumentations-Ticket öffnen aus, um ein neues Ticket zu erstellen. Dieses Feedback ist spezifisch für den Inhalt und wird als Problem in GitHub nachverfolgt.

   

   Optional können Sie Produktfeedback geben auswählen, um zu einem Ziel zu wechseln (z. B. ein Feedbackportal, GitHub, eine E-Mail-Adresse), wo Sie Feedback zu einem Produkt geben können. Dieses Feedback ist unabhängig vom Inhalt und hat keine Beziehung zum ursprünglichen Artikel.

3. Das System öffnet ein neues Issue für Sie im GitHub-Repository, das den Inhalt für den Artikel speichert, den Sie anzeigen. Fügen Sie einen Titel und eine Beschreibung hinzu. Alle anderen Felder werden automatisch ausgefüllt. Klicken Sie auf Neues Problem übermitteln, wenn Sie fertig sind.

   

   Je ausführlicher Ihre Informationen sind, desto nützlicher ist dies für uns. Teilen Sie uns mit, nach welchen Informationen Sie gesucht haben oder welche Suchbegriffe Sie verwendet haben, um zu diesem Artikel zu gelangen. Wenn Ihnen der Einstieg schwerfällt, dann sagen Sie uns einfach, wie Sie sich am liebsten mit neuen Technologien vertraut machen würden. Sie können auch Screenshots oder Dateien hinzufügen, um uns dabei zu helfen, Ihr Ticket zu verstehen.

Das ist alles! Ihr Issue wird nun der Issue-Warteschlange hinzugefügt. Durch Tickets erfahren wir, wo Verbesserungsbedarf besteht. Das Inhaltsteam reagiert dann auf diese Tickets mit Veränderungsvorschlägen und holt Ihre Meinung dazu ein.

Kommentieren eines Issues

Sie können alle Issues in einem Repository kommentieren, das GitHub-Tickets unterstützt. Sie können auch eigene Kommentare zu einem von Ihnen erstellten Issue hinzufügen.

1. Suchen Sie das Issue, das Sie kommentieren möchten. Navigieren Sie in Ihrem Browser zu dem GitHub-Repository, für das Sie sich Issues ansehen möchten. Wählen Sie die RegisterkarteIssues aus, um die offenen Issues für dieses Repository anzuzeigen. Wenn das Repository viele Issues hat, verwenden Sie die Filterleiste , um nach Bezeichnung, Autor und mehr zu filtern. Oder verwenden Sie die Suchleiste, um nach bestimmten Anforderungen zu suchen. Sobald Sie ein Ticket gefunden haben, das Sie interessiert, wählen Sie es aus, um es zu öffnen.

   GitHub-Tickets werden ausschließlich von Open-Source-Produkten akzeptiert, für die die Open-Source-Feedback-Benutzungsoberfläche bereitgestellt wird. Weitere Informationen und eine Liste der beteiligten Repositorys finden Sie unter Verwenden der Open-Source-Benutzungsoberfläche.

2. Lesen Sie das Issue und alle Kommentare, die bereits von anderen Personen hinzugefügt wurden. Wenn Sie einen Kommentar hinzufügen möchten, scrollen Sie zum Ende des Issues, und geben Sie Ihren Kommentar in das Feld Kommentar hinterlassen ein. Wenn Sie fertig sind, wählen Sie Kommentieren aus.

   

Öffnen eines Pull Requests zur Behebung von Issues

Während Sie Issues durchsuchen, finden Sie möglicherweise einen, von dem Sie wissen, wie Sie ihn beheben können. Wenn ja, können Sie einen PR öffnen, um das Issue zu beheben. Weitere Informationen finden Sie unter Dokumentation im Browser bearbeiten.

Nachdem Sie einen PR geöffnet haben, um das Issue zu beheben, kehren Sie zum Issue zurück, und fügen Sie einen Kommentar hinzu, der mit Ihrem PR verknüpft ist. Dies hilft uns, das Issue und den PR zusammen zu verfolgen. Verwenden Sie das Rautezeichen (#) gefolgt von der PR-Nummer, um auf den PR zu verlinken. Wenn Ihre PR-Nummer beispielsweise 4210 ist, würden Sie #4210 in Ihren Kommentar eingeben.