Utilizza un editor di testo nell’ambiente locale per creare una pagina della documentazione di destinazione local-authoring
Le istruzioni in questa pagina mostrano come utilizzare un editor di testo per lavorare nell’ambiente locale per creare la documentazione e inviare una richiesta di pull (PR). Prima di eseguire i passaggi qui indicati, assicurati di aver letto Documento la tua destinazione in Destinazioni Adobe Experience Platform.
Connessione a GitHub e configurazione dell’ambiente di authoring locale set-up-environment
-
Nel browser, passa a
https://github.com/AdobeDocs/experience-platform.en -
Per eseguire il fork dell'archivio, fare clic su Effettuare il fork come illustrato di seguito. In questo modo viene creata una copia dell’archivio di Experienci Platform nel tuo account GitHub.
-
Clona l’archivio nel computer locale. Seleziona Codice > HTTPS > Apri con GitHub Desktop, come illustrato di seguito. Verificare che sia installato GitHub Desktop. Per ulteriori informazioni, leggere Creazione di un clone locale dell'archivio nella guida per i collaboratori Adobe.
-
Nella struttura del file locale, passa a
experience-platform.en/help/destinations/catalog/[...], dove[...]è la categoria desiderata per la destinazione. Se ad Experience Platform si aggiunge una destinazione di personalizzazione, selezionare la cartellapersonalization.
Creare la pagina della documentazione per la destinazione author-documentation
- La pagina della documentazione è basata sul modello di destinazione self-service. Scarica il modello di destinazione. Decomprimere ed estrarre il file
yourdestination-template.mdnella directory indicata al passaggio 4. Rinominare il fileYOURDESTINATION.md, dove YOURDESTINATION è il nome della destinazione in Adobe Experience Platform. Se ad esempio la società si chiama Moviestar, il file verrà denominatomoviestar.md. - Apri il nuovo file nel editor di testo scelto. L'Adobe consiglia di utilizzare Visual Studio Code e installare l'estensione di authoring Markdown dell'Adobe. Per installare l'estensione, aprire Visual Studio Code, selezionare la scheda Extensions a sinistra dello schermo e cercare
adobe markdown authoring. Selezionare l'estensione e fare clic su Install.
- Modifica il modello con le informazioni rilevanti per la destinazione. Segui le istruzioni nel modello.
- Per qualsiasi schermata o immagine che intendi aggiungere alla documentazione, vai a
GitHub/experience-platform.en/help/destinations/assets/catalog/[...], dove[...]è la categoria desiderata per la tua destinazione. Se ad Experience Platform si aggiunge una destinazione di personalizzazione, selezionare la cartellapersonalization. Crea una nuova cartella per la destinazione e salva qui le immagini. Devi creare un collegamento a tali elementi dalla pagina in cui vengono creati. Consulta istruzioni su come collegare le immagini. - Quando si è pronti, salvare il file su cui si sta lavorando.
Inviare la documentazione per la revisione submit-review
- In GitHub Desktop, crea un ramo di lavoro per gli aggiornamenti e seleziona ramo Publish per pubblicare il ramo in GitHub.
-
Nel desktop GitHub, conferma il tuo lavoro, come mostrato di seguito.
-
In GitHub Desktop, invia il tuo lavoro al ramo remoto, come mostrato di seguito.
-
Nell’interfaccia web GitHub, apri una richiesta di pull (PR) per unire il ramo di lavoro nel ramo principale dell’archivio della documentazione di Adobe. Assicurati che il ramo su cui hai lavorato sia selezionato e seleziona Contribute > Apri richiesta di pull.
-
Assicurati che i rami di base e di confronto siano corretti. Aggiungi una nota alla PR con la descrizione dell'aggiornamento e seleziona Crea richiesta di pull. Viene aperto un PR per unire il ramo di lavoro del fork nel ramo principale dell’archivio di Adobi.
note tip TIP Lascia selezionata la casella di controllo Consenti modifiche da parte dei gestori in modo che il team della documentazione di Adobe possa apportare modifiche all'PR. 
-
A questo punto, viene visualizzata una notifica che richiede di firmare il Contratto di licenza da collaboratore (CLA) di Adobe. Questo è un passaggio obbligatorio. Dopo aver firmato il contratto di licenza, aggiorna la pagina PR e invia la richiesta di pull.
-
Puoi confermare che la richiesta di pull è stata inviata esaminando la scheda Richieste pull in
https://github.com/AdobeDocs/experience-platform.en.
- Grazie. Il team di documentazione di Adobe si rivolgerà al PR nel caso siano necessarie modifiche e ti informerà di quando la documentazione verrà pubblicata.