Utiliser un éditeur de texte dans votre environnement local pour créer une page de documentation sur les sources
Ce document décrit les étapes à suivre pour utiliser votre environnement local afin de créer de la documentation pour votre source et d’envoyer une requête de tirage (PR).
Conditions préalables
Le tutoriel suivant nécessite que GitHub Desktop soit installé sur votre ordinateur local. Si vous ne disposez pas de l’appli de bureau GitHub, vous pouvez télécharger l’application here.
Connexion à GitHub et configuration de votre environnement de création local
La première étape de la configuration de votre environnement de création local consiste à accéder au Référentiel GitHub Adobe Experience Platform.
Sur la page principale du référentiel Platform GitHub, sélectionnez Branchement.
Pour cloner le référentiel sur votre ordinateur local, sélectionnez Code. Dans le menu déroulant qui s’affiche, sélectionnez HTTPS puis sélectionnez Ouverture avec GitHub Desktop.
Ensuite, laissez quelques instants à GitHub Desktop pour cloner la variable experience-platform.en
référentiel.
Une fois le processus de clonage terminé, accédez à GitHub Desktop pour créer une nouvelle branche. Sélectionner Principal dans le volet de navigation supérieur, puis sélectionnez Nouvelle branche
Dans le panneau contextuel qui s’affiche, saisissez un nom descriptif pour votre branche, puis sélectionnez Créer une branche.
Ensuite, sélectionnez Publier la branche.
Créez la page de documentation de votre source.
Une fois le référentiel cloné sur votre ordinateur local et une nouvelle branche créée, vous pouvez maintenant commencer à créer la page de documentation de votre nouvelle source via le éditeur de texte de votre choix.
Adobe recommande d’utiliser Visual Studio Code et que vous installez l’extension Adobe Markdown Authoring. Pour installer l’extension, lancez Visual Studio Code, puis sélectionnez la variable Extensions dans le volet de navigation de gauche.
Ensuite, saisissez Adobe Markdown Authoring
dans la barre de recherche, puis sélectionnez Installer de la page qui s’affiche.
Lorsque votre ordinateur local est prêt, téléchargez le fichier modèle de documentation sources et extrayez le fichier vers experience-platform.en/help/sources/tutorials/api/create/...
avec [...
] représentant la catégorie de votre choix. Par exemple, si vous créez une source de base de données, sélectionnez le dossier de base de données.
Enfin, suivez les instructions décrites dans le modèle et modifiez-le avec les informations pertinentes concernant votre source.
Soumettre votre documentation pour révision
Pour créer une requête de tirage (PR) et envoyer votre documentation pour révision, enregistrez d’abord votre travail dans Visual Studio Code (ou l’éditeur de texte de votre choix). Ensuite, à l’aide de GitHub Desktop, saisissez un message de validation et sélectionnez Valider à create-source-documentation.
Ensuite, sélectionnez Origine push pour charger votre travail dans la branche distante.
Pour créer une requête d’extraction, sélectionnez Créer une requête d’extraction.
Assurez-vous que les branches de base et de comparaison sont correctes. Ajoutez une note au communiqué, décrivant votre mise à jour, puis sélectionnez Création d’une requête d’extraction. Cela ouvre une requête de tirage pour fusionner la branche opérationnelle de votre travail dans la branche principale du référentiel Adobe.
Vous pouvez confirmer que la demande d’extraction a été envoyée en consultant l’onglet des demandes d’extraction dans https://github.com/AdobeDocs/experience-platform.en.