Documenter votre destination dans Adobe Experience Platform

Vue d’ensemble

Bienvenue à Adobe Experience Platform, super de vous avoir ici !
La documentation de votre destination est la dernière étape avant qu’elle ne puisse être définie dans Adobe Experience Platform.

Cette section de documentation comprend :

• Cette section contient des instructions détaillées pour vous permettre de créer une page de documentation pour votre nouvelle destination.
• Un modèle à remplir pour votre destination ;
• Instructions générales sur l’utilisation de Markdown;
• Instructions spécifiques pour la saveur Adobe Markdown (La saveur Adobe Markdown est très similaire à Markdown standard).
• A page bonnes pratiques pour vous aider à créer une page de documentation pour votre page de destination, qui respecte les normes de qualité de la documentation Experience Platform.

Conditions préalables

Pour créer la documentation de votre destination conformément aux instructions de cet article, les éléments suivants sont nécessaires :

• Un compte GitHub. Inscrivez-vous à GitHub si vous n'avez pas encore de compte.
• GitHub Desktop. Si vous sélectionnez créer la documentation dans votre environnement local ;, vous devez GitHub Desktop.
• Votre intégration à Adobe doit être dans une phase de test avec votre destination déployée dans un environnement d’évaluation dans Adobe Experience Platform.

Instructions de haut niveau pour créer de la documentation pour votre destination dans Adobe Experience Platform

À un niveau général, pour créer de la documentation pour votre destination, vous devez : création d’un double du référentiel de documentation Adobe Experience Platform et modifiez la variable modèle de documentation fourni dans une nouvelle branche. Utilisez le modèle fourni par l’Adobe pour créer une page de destination. Ouvrez une requête de tirage (PR) lorsque vous êtes prêt. Les instructions à suivre pour ce faire sont présentées ci-dessous : Procédure de création d’une page de destination.

Modèle de documentation

Pour vous aider à créer votre page de documentation, Adobe a prérempli un modèle de documentation pour vous. Vous trouverez ci-dessous des instructions pour modifier le modèle et ouvrir une requête d’extraction. L’équipe de documentation de l’Adobe examinera et publiera la documentation relative à votre nouvelle destination.

Téléchargez le modèle ici et décompressez le fichier pour extraire le fichier yourdestination.md fichier .

Vous trouverez ci-dessous des instructions sur l’utilisation du modèle pour créer votre page de documentation.

Procédure de création d’une page de destination

Vous pouvez utiliser l’interface web GitHub ou votre environnement local pour créer de la documentation pour votre nouvelle destination dans Adobe Experience Platform. Recherchez des instructions pour les deux options dans les liens ci-dessous :

• Utiliser l’interface web GitHub pour créer une page de documentation de destination
• Utiliser un éditeur de texte dans votre environnement local pour créer une page de documentation de destination

Bonnes pratiques

Consultez la section bonnes pratiques de création avant et pendant que vous créez la page de documentation de destination. Veillez également à lire le rédaction de conseils pour la documentation Adobe pour obtenir d’autres conseils d’écriture que l’équipe de documentation d’Adobe utilise lors de la création de la documentation.