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

  • 4 Minuten

Lassen Sie uns den Beitragsworkflow üben. 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 Artikels 'Beitragen', auf dem das Bleistiftsymbol für Bearbeitung hervorgehoben ist.

  4. Wählen Sie das Bleistiftsymbol, um dieses Repository zu forken und in Ihrem Fork zu bearbeiten oder diese Datei in Ihrem Fork dieses Projekts zu bearbeiten.

    Screenshot der Quelldatei des Beitrag-Artikels, die in einem Browser geöffnet ist, wobei das Symbol zum Bearbeiten 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 hostet alle Dokumentationen für Microsoft-Produkte und -Technologien.

    Screenshot der Datei

Ö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, klicken Sie auf Änderungen bestätigen.

  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 vergleichen, ob für die main angezeigt wird. Dies bedeutet, dass Ihre Änderungen in den Hauptzweig im Live-Repository übernommen 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 Live-Website zusammengeführt.

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.