Übung: Beitragen zu einem Artikel in der Microsoft Learn-Dokumentation

  • 4 Minuten

Im Folgenden üben Sie die Durchführung des Beitragsworkflows. In dieser Übung nehmen Sie eine kleine Änderung an einem Open-Source-Dokumentationsartikel auf Microsoft Learn vor. Anschließend schlagen Sie Ihre Änderungen vor, indem Sie einen Pull Request erstellen.

Bearbeiten des Artikels

  1. Melden Sie sich bei Ihrem GitHub-Konto an.

  2. Navigieren Sie in einem Browsertab zu learn.microsoft.com/contribute/content.

  3. Klicken Sie oben im Artikel auf das Bleistiftsymbol Bearbeiten.

    Screenshot des geöffneten Beitrags zum Mitwirken, auf dem das Bearbeitungssymbol (Bleistift) hervorgehoben ist.

  4. Über das Stiftsymbol können Sie Dieses Repository forken und in Ihrem Fork bearbeiten bzw. Diese Datei in Ihrem Fork dieses Projekts bearbeiten auswählen.

    Screenshot der in einem Browser geöffneten Quelldatei des Artikels zum Mitwirken, bei dem das Bearbeitungssymbol hervorgehoben ist.

  5. Wenn Sie auf der nächsten Seite von GitHub aufgefordert werden, das Repository zu forken, wählen Sie Repository forken aus.

  6. Der Bereich Datei bearbeiten wird geöffnet. Sie müssen am Anfang dieses Artikels einen neuen Satz hinzufügen. Fügen Sie am Anfang des zweiten Absatzes den folgenden Satz hinzu: „Microsoft Learn hosts all documentation for Microsoft products and technologies.“

    Screenshot der bearbeiteten Datei des Artikels zum Mitwirken mit einem neuen Satz, wobei die Schaltfläche „Änderungen committen“ hervorgehoben ist.

Öffnen eines PR

  1. Zeigen Sie eine Vorschau Ihrer Änderungen an, indem Sie die Registerkarte Vorschau auswählen.

  2. Wenn Sie mit Ihren Änderungen fertig sind, suchen Sie nach der Option Änderungen committen, und wählen Sie sie aus.

  3. Geben Sie im Feld Commitnachricht den Text „TEST contribution“ ein.

    Screenshot des Felds der Commit-Nachricht, das mit dem Beitrag „TEST“ ausgefüllt ist.

  4. Wählen Sie Änderungen vorschlagen aus.

  5. Überprüfen Sie auf der Seite Änderungen verglichen, ob main für die Basis angezeigt wird. Dies bedeutet, dass Ihre Änderungen in den Mainbranch im Liverepository gepullt werden.

    Screenshot der Seite, auf der Sie sich vergewissern können, dass die Basis „Main“ ist, d.h. dass die Änderungen in den Mainbranch zusammengeführt werden.

    Hinweis

    Wenn die Optionen base repository und head repository auf dieser Seite nicht angezeigt werden, wählen Sie die Option zum forkübergreifenden Vergleichen aus. Dadurch werden die für diesen Schritt erforderlichen Vergleichsoptionen angezeigt.

  6. Wählen Sie die Schaltfläche Pull Request erstellen aus.

  7. Dadurch gelangen Sie zur Seite Pull Request öffnen, auf der Sie eine Vorschau Ihres PR anzeigen können.

  8. Bestätigen Sie Ihren PR, und wählen Sie Pull Request erstellen aus, um ihn zu öffnen.

    Screenshot des geöffneten PR.

Hinweis

Da dies eine Übung ist, werden Ihre Änderungen nicht mit der Livewebsite gemergt.

Herzlichen Glückwunsch zur Erstellung Ihres Pull Requests! Er wurde noch nicht übermittelt, aber Sie haben den ersten wichtigen Schritt zum Leisten eines Beitrags abgeschlossen. Lassen Sie die PR-Registerkarte in Ihrem Browser geöffnet. Sie werden ihn in der nächsten Übung erneut verwenden.