Dokumentieren des Ziels in Adobe Experience Platform
Übersicht overview
Willkommen in Adobe Experience Platform, ein tolles Angebot für Sie!
Die Dokumentation Ihres Ziels ist der letzte Schritt, bevor es in Adobe Experience Platform live gesetzt werden kann.
Dieser Dokumentationsabschnitt umfasst:
- Schrittweise Anleitungen zum Erstellen einer Dokumentationsseite für Ihr neues Ziel;
- eine Vorlage, die Sie für Ihr Ziel ausfüllen können;
- Allgemeine Anweisungen zur Verwendung von Markdown;
- Spezifische Anweisungen für den Adobe Markdown-Geschmack (Der Markdown-Geschmack von Adobe ähnelt dem regulären Markdown sehr.)
- A Best Practices-Seite um Ihnen zu helfen, eine Dokumentationsseite für Ihre Zielseite zu erstellen, die den Qualitätsstandards der Experience Platform-Dokumentation entspricht.
Voraussetzungen prerequisites
Um die Dokumentation für Ihr Ziel gemäß den Anweisungen in diesem Artikel zu erstellen, sind die folgenden Elemente erforderlich:
- Ein GitHub-Konto. Registrieren Sie sich für GitHub wenn Sie noch kein Konto haben.
- GitHub Desktop. Wenn Sie auswählen, Erstellen Sie die Dokumentation in Ihrer lokalen Umgebung, müssen Sie GitHub Desktop.
- Ihre Integration mit Adobe muss sich in einer Testphase befinden, während Ihr Ziel in einer Staging-Umgebung in Adobe Experience Platform bereitgestellt wird.
Allgemeine Anweisungen zum Erstellen der Dokumentation für Ihr Ziel in Adobe Experience Platform high-level-instructions
Auf einer übergeordneten Ebene müssen Sie zur Erstellung der Dokumentation für Ihr Ziel eine Abspaltung erstellen des Adobe Experience Platform-Dokumentations-Repositorys erstellen und die bereitgestellte Dokumentationsvorlage in einer neuen Verzweigung. Verwenden Sie die vom Adobe bereitgestellte Vorlage, um eine neue Zielseite zu erstellen. Öffnen Sie eine Pull-Anforderung (PA), wenn Sie bereit sind. Anweisungen hierzu finden Sie weiter unten unter Schritte zum Erstellen Ihrer neuen Zielseite.
Dokumentationsvorlage documentation-template
Um Sie bei der Erstellung Ihrer Dokumentationsseite zu unterstützen, hat Adobe bereits eine Dokumentationsvorlage für Sie. Weiter unten finden Sie Anweisungen zum Bearbeiten der Vorlage und Öffnen einer Pull-Anforderung. Das Adobe-Dokumentationsteam prüft und veröffentlicht die Dokumentation für Ihr neues Ziel.
Laden Sie die Vorlage hier herunter und entpacken Sie die Datei, um die yourdestination.md
-Datei.
Anweisungen zur Verwendung der Vorlage zum Erstellen Ihrer Dokumentationsseite finden Sie weiter unten.
Schritte zum Erstellen Ihrer neuen Zielseite steps-to-create-docs-page
Sie können die GitHub-Webschnittstelle oder Ihre lokale Umgebung verwenden, um eine Dokumentation für Ihr neues Ziel in Adobe Experience Platform zu erstellen. Anweisungen für beide Optionen finden Sie unter den folgenden Links:
Best Practices best-practices
Überprüfen Sie die Best Practices für die Bearbeitung vor und während Sie die Zieldokumentation erstellen. Lesen Sie auch die Schreibanleitung für Adobe-Dokumentation für einige weitere Tipps zum Schreiben, die das Adobe-Dokumentationsteam beim Erstellen der Dokumentation verwendet.