DocumentationExperience PlatformGuide des destinations

Utiliser l’interface web GitHub pour créer une page de documentation de destination github-interface

Last update: Wed Nov 01 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
  • User

Les instructions ci-dessous vous montrent comment utiliser l’interface web GitHub pour créer de la documentation et envoyer une requête de tirage (PR). Avant de suivre les étapes indiquées ici, veillez à lire Document de votre destination dans les destinations Adobe Experience Platform.

TIP
Reportez-vous également à la documentation à l’appui du guide du contributeur d’Adobe :

Configuration de votre environnement de création GitHub set-up-environment

  1. Dans votre navigateur, accédez à la page suivante : https://github.com/AdobeDocs/experience-platform.en.

  2. À double le référentiel, cliquez sur Branchement comme illustré ci-dessous. Cela crée une copie du référentiel Experience Platform dans votre propre compte GitHub.

    Référentiel de documentation pour les Adobes de transfert

  3. Dans le branchement du référentiel, créez une branche pour votre projet, comme illustré ci-dessous. Utilisez cette nouvelle branche pour votre travail.

    Création d’une branche GitHub

  4. Dans la structure de dossiers GitHub du référentiel dupliqué, accédez à experience-platform.en/help/destinations/catalog/[...], où [...] est la catégorie souhaitée pour votre destination. Par exemple, si vous ajoutez une destination de personnalisation à Experience Platform, sélectionnez la variable personalization catégorie. Sélectionner Ajouter un fichier > Créer un fichier.

    Ajouter un nouveau fichier

  5. Nommer votre destination YOURDESTINATION.md, où YOURDESTINATION est le nom de votre destination dans Adobe Experience Platform. Par exemple, si votre société s’appelle Moviestar, vous nommerez votre fichier . moviestar.md.

Créez la page de documentation de votre destination. author-documentation

  1. Vous allez créer le contenu de votre page de destination en fonction du modèle de libre-service de documentation. Télécharger le modèle et décompressez-le pour extraire le .md modèle de fichier.

  2. Collez et modifiez le contenu du modèle avec les informations pertinentes pour votre destination dans un éditeur de balisage en ligne, tel que dillinger.io. Suivez les instructions du modèle pour plus d’informations sur ce que vous devez remplir et les paragraphes qui peuvent être supprimés.

    note tip
    TIP
    Vous pouvez fermer la fenêtre de votre navigateur à tout moment et la rouvrir ultérieurement. Votre travail est enregistré automatiquement et vous attend lorsque vous rouvrez le navigateur.

    3. Copiez le contenu de l’éditeur de Markdown dans votre nouveau fichier dans GitHub.

  3. Pour toutes les captures d’écran ou images que vous prévoyez d’utiliser, utilisez l’interface GitHub pour charger les fichiers dans experience-platform.en/help/destinations/assets/catalog/[...], où [...] est la catégorie souhaitée pour votre destination. Par exemple, si vous ajoutez une destination de personnalisation à Experience Platform, sélectionnez la variable personalization catégorie. Vous devez créer un lien vers les images de la page que vous créez. Voir instructions pour créer un lien vers des images.

    Chargement d’une image sur GitHub

  4. Lorsque vous êtes prêt, enregistrez le fichier dans votre branche.

Confirmer la création du fichier

Soumettre votre documentation pour révision submit-review

TIP
Notez qu’il n’y a rien que vous puissiez casser ici. En suivant les instructions de cette section, vous proposez simplement une mise à jour de la documentation. Votre mise à jour suggérée sera approuvée ou modifiée par l’équipe de documentation de Adobe Experience Platform.
  1. Après avoir enregistré le fichier et téléchargé les images de votre choix, vous pouvez ouvrir une requête de tirage (PR) pour fusionner votre branche de travail dans la branche principale du référentiel de documentation Adobe. Assurez-vous que la branche sur laquelle vous avez travaillé est sélectionnée et sélectionnez Contribution > Ouvrir la requête de tirage.

Création d’une requête d’extraction

  1. Assurez-vous que les branches de base et de comparaison sont correctes. Ajoutez une note au document de présentation, 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 double dans la branche principale du référentiel Adobe.

    note tip
    TIP
    Laissez le champ Autorisation des modifications par les responsables case à cocher sélectionnée afin que l’équipe de documentation d’Adobe puisse apporter des modifications au résiduel.

    Création d’une requête d’extraction pour Adobe du référentiel de documentation

  2. À ce stade, une notification s’affiche pour vous inviter à signer le contrat de licence du contributeur Adobe (CLA). Cette étape est obligatoire. Après avoir signé le contrat de licence du contributeur, actualisez la page de requête de tirage et envoyez la requête de tirage.

  3. Vous pouvez confirmer que la demande d’extraction a été envoyée en examinant la variable Requêtes de tirage dans https://github.com/AdobeDocs/experience-platform.en.

    PR réussi

  4. Merci ! L’équipe de documentation de l’Adobe contactera le service des relations publiques si des modifications sont nécessaires et vous indiquera quand la documentation sera publiée.

TIP
Pour ajouter des images et des liens à votre documentation, ainsi que toute autre question concernant Markdown, reportez-vous à la section Utilisation de Markdown dans le guide d’écriture collaborative d’Adobe.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6