Verwenden eines Texteditors in Ihrer lokalen Umgebung, um die Seite mit der Quellendokumentation zu erstellen.

In diesem Dokument wird beschrieben, wie Sie mit Ihrer lokalen Umgebung die Dokumentation für Ihre Quelle erstellen und eine Pull-Anfrage (PR) senden.

TIP
Die folgenden Dokumente aus dem Handbuch zum Beitragen zur Adobe können verwendet werden, um Ihren Dokumentationsprozess weiter zu unterstützen:

Voraussetzungen

Für das folgende Tutorial muss GitHub Desktop auf Ihrem lokalen Computer installiert sein. Wenn Sie keinen GitHub-Desktop haben, können Sie die Anwendung ().

Verbinden mit GitHub und Einrichten der lokalen Authoring-Umgebung

Der erste Schritt beim Einrichten Ihrer lokalen Authoring-Umgebung besteht darin, zum Adobe Experience Platform GitHub-Repository zu.

platform-repo

Wählen Sie auf der Hauptseite des Platform-GitHub-Repositorys die Option Verzweigung aus.

Verzweigung

Um das Repository auf Ihren lokalen Computer zu klonen, wählen Sie Code aus. Wählen Sie aus dem angezeigten Dropdown-Menü HTTPS und klicken Sie dann auf Mit GitHub Desktop öffnen.

TIP
Weitere Informationen finden Sie im Tutorial zum Einrichten eines lokalen Git-Repositorys für die -Dokumentation.

open-git-desktop

Warten Sie als Nächstes einige Augenblicke, bis GitHub Desktop das experience-platform.en-Repository geklont hat.

Klonen

Sobald der Klonvorgang abgeschlossen ist, gehen Sie zu GitHub Desktop , um eine neue Verzweigung zu erstellen. Wählen Sie oberen Navigationsbereich die Option Master“ und dann Neue Verzweigung

neuer Zweig

Geben Sie im angezeigten Popup-Fenster einen beschreibenden Namen für Ihre Verzweigung ein und wählen Sie dann Verzweigung erstellen aus.

create-branch-vs

Wählen Sie als Nächstes Publish-Verzweigung.

publish-branch

Erstellen der Dokumentationsseite für Ihre Quelle

Nachdem das Repository auf den lokalen Computer geklont und eine neue Verzweigung erstellt wurde, können Sie jetzt mit dem Erstellen der Dokumentationsseite für Ihre neue Quelle über den Texteditor Ihrer Wahl beginnen.

Adobe empfiehlt die Verwendung von Visual Studio Code und die Installation der Adobe Markdown Authoring-Erweiterung. Um die Erweiterung zu installieren, starten Sie Visual Studio Code, und wählen Sie dann im linken Navigationsbereich Registerkarte Erweiterungen“ aus.

-Erweiterung

Geben Sie als Nächstes Adobe Markdown Authoring in die Suchleiste ein und wählen Sie dann auf der Seite die Option Installieren“ aus.

Installieren

Wenn Ihr lokaler Computer bereit ist, laden Sie die Quelldokumentationsvorlage herunter und extrahieren Sie die Datei, um mit [...] zu experience-platform.en/help/sources/tutorials/api/create/..., die die Kategorie Ihrer Wahl darstellt. Wenn Sie beispielsweise eine Datenbankquelle erstellen, wählen Sie den Datenbankordner aus.

Befolgen Sie abschließend die auf der Vorlage beschriebenen Anweisungen und bearbeiten Sie die Vorlage mit den relevanten Informationen zu Ihrer Quelle.

edit-template

Reichen Sie Ihre Dokumentation zur Überprüfung ein

Um eine Pull-Anfrage (PR) zu erstellen und Ihre Dokumentation zur Überprüfung zu senden, speichern Sie zunächst Ihre Arbeit in Visual Studio Code (oder in Ihrem ausgewählten Texteditor). Geben Sie als Nächstes mithilfe von GitHub Desktop eine Commit-Nachricht ein und wählen Sie Commit an create-source-documentation.

commit-vs

Wählen Sie als Nächstes Push-Herkunft aus, um Ihre Arbeit in die Remote-Verzweigung hochzuladen.

push-origin

Um eine Pull-Anfrage zu erstellen, wählen Sie Pull-Anfrage erstellen aus.

create-pr-vs

Stellen Sie sicher, dass die Basis- und Vergleichsverzweigungen korrekt sind. Fügen Sie der PR einen Hinweis hinzu, der Ihre Aktualisierung beschreibt, und wählen Sie dann Pull-Anfrage erstellen aus. Dadurch wird ein PR geöffnet, in dem der Arbeitszweig Ihrer Arbeit mit dem Hauptzweig des Adobe-Repositorys zusammengeführt wird.

TIP
Lassen Sie das Bearbeitungen von Betreuern zulassen aktiviert, um sicherzustellen, dass das Adobe-Dokumentations-Team Änderungen am PR vornehmen kann.

create-pr

Sie können bestätigen, dass die Pull-Anforderung gesendet wurde, indem Sie die Registerkarte Pull-Anforderungen in https://github.com/AdobeDocs/experience-platform.en überprüfen.

confirm-pr

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089