Utilizza l’interfaccia web GitHub per creare una pagina della documentazione di destinazione github-interface
Le istruzioni seguenti mostrano come utilizzare l’interfaccia web GitHub 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.
Configurare l’ambiente di authoring GitHub set-up-environment
-
Nel browser, passa a
https://github.com/AdobeDocs/experience-platform.it-IT. -
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 Experience Platform nel tuo account GitHub.
-
Nel fork dell’archivio, crea un nuovo ramo per il progetto, come illustrato di seguito. Utilizza questo nuovo ramo per il tuo lavoro.
-
Nella struttura di cartelle GitHub dell'archivio con fork, passa a
experience-platform.en/help/destinations/catalog/[...], dove[...]è la categoria desiderata per la destinazione. Ad esempio, se stai aggiungendo una destinazione di personalizzazione ad Experience Platform, seleziona la categoriapersonalization. Selezionare Aggiungi file > Crea nuovo file.
-
Assegna un nome alla destinazione
YOURDESTINATION.md, dove YOURDESTINATION è il nome della destinazione in Adobe Experience Platform. Se ad esempio la società si chiama Moviestar, il file verrà denominatomoviestar.md.
Creare la pagina della documentazione per la destinazione author-documentation
-
Verrà creato il contenuto della pagina di destinazione in base al modello self-service della documentazione. Scarica il modello e decomprimi per estrarre il modello di file
.md. -
Incolla e modifica il contenuto del modello con le informazioni rilevanti per la destinazione in un editor markdown online, ad esempio dillinger.io. Seguire le istruzioni nel modello per i dettagli su cosa compilare e quali paragrafi possono essere rimossi.
note tip TIP Puoi chiudere la finestra del browser in qualsiasi momento e riaprirla in un secondo momento. Il tuo lavoro viene salvato automaticamente e ti aspetta quando riapri il browser. 1. Copia il contenuto dall’editor markdown nel nuovo file in GitHub.
-
Per qualsiasi schermata o immagine che intendi utilizzare, utilizza l'interfaccia GitHub per caricare i file in
experience-platform.en/help/destinations/assets/catalog/[...], dove[...]è la categoria desiderata per la tua destinazione. Ad esempio, se stai aggiungendo una destinazione di personalizzazione ad Experience Platform, seleziona la categoriapersonalization. Devi collegare alle immagini dalla pagina che stai creando. Consulta istruzioni su come collegare le immagini.
-
Quando sei pronto, salva il file nel ramo.
Inviare la documentazione per la revisione submit-review
-
Dopo aver salvato il file e caricato le immagini desiderate, puoi aprire 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 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 Adobe.
note tip TIP Lascia selezionata la casella di controllo Consenti modifiche da parte dei responsabili della manutenzione in modo che il team di documentazione di Adobe possa apportare modifiche alla 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.it-IT.
-
Grazie. Il team di documentazione di Adobe contatterà la PR nel caso siano necessarie modifiche e per informarti di quando la documentazione verrà pubblicata.