Übersicht über die Bearbeitungsdokumentation zu Microsoft Learn

Vielen Dank für Ihr Interesse an der Bearbeitungsdokumentation auf Microsoft Learn! Ihre Beiträge helfen uns, sicherzustellen, dass unsere Dokumentation gut geschrieben, aktuell und genau ist. Die Informationen auf dieser Seite helfen Ihnen bei der Entscheidung, welche Beitragsmethode für Sie am besten geeignet ist.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie bei Ihrem GitHub-Konto angemeldet sind. Wenn Sie nicht über ein GitHub-Konto verfügen, navigieren Sie zu https://github.com/join einem schnellen und kostenlosen Anmeldevorgang.

Kleinere Änderungen an der Dokumentation

Kleinere Änderungen sind schnell und einfach. Beispiele für geringfügige Änderungen sind:

  • Beheben von Tippfehlern
  • Überarbeiten eines einzelnen Artikels
  • Hinzufügen eines Abschnitts zu einem Artikel
  • Korrigieren eines Fehlers
  • Aktualisieren fehlerhafter Verknüpfungen

Wenn Sie kleinere Änderungen vornehmen, benötigen Sie lediglich ein GitHub-Konto!

Um eine kleinere Änderung vorzunehmen, wählen Sie oben im Artikel das Stiftsymbol "Dieses Dokument bearbeiten" aus. Diese Aktion führt Sie zur Quelldatei auf GitHub, in der Sie Ihre Änderungen vornehmen können. Wenn Sie fertig sind, werden Sie aufgefordert, eine Pull-Anforderung (PR) zu erstellen, um Ihre Änderungen vorzuschlagen. Eine vollständige exemplarische Vorgehensweise für diesen Prozess finden Sie in der Dokumentation zum Bearbeiten im Browser.

Wichtige Änderungen an der Dokumentation

Große Änderungen erfordern mehr Zeit und Mühe. Beispiele für wichtige Änderungen sind:

  • Komplexe Änderungen, die mehrere Tage dauern, bis sie abgeschlossen sind
  • Überarbeitungen an mehreren Artikeln, die Sie zusammen übermitteln möchten
  • Erstellen eines neuen Artikels
  • Häufig beitragen

Wenn Sie wichtige Änderungen vornehmen, müssen Sie einige Tools herunterladen und installieren, um Ihre Arbeit zu vereinfachen. Befolgen Sie diese Schritte, um mit der Prüfung zu beginnen:

  1. Installieren Sie die Git- und Markdown-Tools
  2. Richten Sie ein lokales Git-Repository ein
  3. Nehmen Sie Änderungen an der Dokumentation vor.
  4. Erstellen Sie eine PR.

Übersicht über den Prozess

Der folgende Prozessfluss zeigt die allgemeinen Schritte, die bei den ersten Schritten für kleinere und wichtige Änderungen erforderlich sind. Beachten Sie, dass einige Elemente einmalige Schritte sind, während andere jedes Mal auftreten, wenn Sie einen neuen Beitrag starten.

Process flow map showing the basic workflow for getting started with the contribution process.

Das Bild beginnt mit einem Entscheidungspunkt: Ist dies Ihr erster Beitrag? Wenn ja, besteht der nächste Schritt darin, Ihr GitHub-Konto einzurichten. Wenn nein, ist der nächste Schritt ein weiterer Entscheidungspunkt: Ist Ihre Änderung geringfügig? Wenn ja, ist der nächste Schritt die Bearbeitung im Browser. Wenn nein, sind die nächsten Schritte die Installation von Erstellungstools, das Forken und Klonen des Repositorys, das Vornehmen von Änderungen, das Öffnen einer Pull-Anfrage und das Überprüfen und Absegnen Ihrer Pull-Anfrage.

Änderungen an Schulungsmodulen

Mitwirkende können keine Änderungen an Schulungsmodulen bearbeiten oder vorschlagen. Derzeit ist nur die in öffentlichen Repositorys gespeicherte Microsoft Learn-Dokumentation für öffentliche Beiträge geöffnet.