Überprüfen der Dokumentation mit GitHub-Issues

Abgeschlossen

Eine der nützlichsten Möglichkeiten, zu Microsoft Learn beizutragen, ist, direktes Feedback zu einem Dokumentationsartikel zu geben. Über den Feedback-Link auf der Seite können Sie uns Änderungen, Vorschläge, Fragen oder andere Erkenntnisse mitteilen, die Sie beim Stöbern entdecken. Da die meisten Inhalte der Microsoft Learn-Dokumentation in GitHub-Repositorys gespeichert sind, können Sie Ihr Feedback über einen GitHub-Prozess, das sogenannte Übermitteln eines GitHub-Issues, abgeben.

Ein Issue in GitHub ist ein Tool, mit dem Technologieanwender*innen, Ingenieur*innen und andere Besucher*innen von Microsoft Learn Feedback zu einem bestimmten Artikel teilen und nachverfolgen können. Sie füllen ein Formular aus, um Ihr Feedback zu dokumentieren und posten es im Repository des Quellartikels auf GitHub, wo ein*e Autor*in oder Eigentümer*in benachrichtigt wird. Jeder, der das GitHub-Repository besucht, kann Issues sehen. Sie dienen dazu, wertvolles Feedback zu sammeln und zu speichern, wie z. B. das Melden von Fehlern, Funktionsanforderungen oder Notizen.

Warum sollten Sie Inhalte auf GitHub überprüfen?

Die Bereitstellung von Inhaltsbewertungen auf GitHub ist ein direkter Weg, um zu einem Thema beizutragen, für das Sie sich begeistern oder in dem Sie sich auskennen. Das bedeutet, dass Sie Ihre Ideen hinzufügen können, während Sie sich mit einem Thema in der Microsoft-Dokumentation beschäftigen. Wenn Sie Ihre Erkenntnisse zum Wissenspool beitragen, können Sie die Microsoft-Produkterfahrungen für Millionen anderer Benutzer*innen verbessern. Ihr Feedback entwickelt Inhalte für andere Microsoft Learn-Benutzer*innen, die auf Microsoft-Produkte und ihre unterstützenden Inhalte angewiesen sind.

In den meisten Fällen können Sie mit dem Übermitteln von GitHub-Feedback Ihre Ideen an das Team senden, das für den Inhaltssatz des Produkts zuständig ist. Dieser Weg der Zusammenarbeit zwischen Content-Teams und Produktnutzer*innen ermöglicht den Austausch und die Diskussion von Feedback direkt in GitHub.

Der Beitrag zu Dokumentationsinhalten kann auch für Sie berufliche Vorteile mit sich bringen. GitHub ist eine bekannte Plattform, auf der technische Beiträge erstellt und nachverfolgt werden können. Jedes Mal, wenn Sie auf GitHub zu einem Projekt beitragen, wird dies in Ihrem GitHub-Profil angezeigt. Mit der Zeit können Sie eine Liste mit Ihren Beiträgen erstellen, die Sie Ihrem technischen Portfolio hinzufügen können.

So geben Sie Feedback zum Inhalt

Erinnern Sie sich daran, dass viele Dokumentationsartikel zu Microsoft Learn in GitHub-Repositorys gespeichert sind. In vielen GitHub-Repositorys sind GitHub-Issues aktiviert. Wenn diese Option aktiviert ist, finden Sie am Ende eines Artikels die Möglichkeit, Feedback zu dieser Seite zu senden.

Screenshot der Feedbackoptionen am Ende eines Dokumentationsartikels.

Hier erfahren Sie, wie Sie aus einem Microsoft Learn-Artikel ein Issue in GitHub übermitteln:

  1. Navigieren Sie zum Microsoft Learn-Dokumentationsartikel, zu dem Sie Feedback geben möchten.

  2. Suchen Sie unter dem Artikel die Überschrift Feedback. Neben der Frage War diese Seite hilfreich?, gibt es Schaltflächen für Ja und Nein. Wählen Sie eine Schaltfläche aus, um anzugeben, ob der Artikel hilfreich war. Dadurch wird ein Formular geöffnet, in dem Sie Ihre Kommentare ausfüllen können.

  3. Wählen Sie den Grund für Ihr Feedback aus.

  4. Beschreiben Sie im folgenden Textfeld Ihr Feedback, und geben Sie alle erforderlichen Kontexte ein.

  5. Wenn Sie fertig sind, wählen Sie "Absenden" aus.

Screenshot eines leeren GitHub-Problemformulars zum Übermitteln von Feedback zu einem Dokumentationsartikel.

Der Autor des Artikels oder andere Inhaltsbesitzer werden benachrichtigt, wenn Sie Ihr Problem übermitteln.