Esercizio - Contribuire a un articolo della documentazione di Microsoft Learn

  • 4 minuti

Provare ora il flusso di lavoro dei contributi. In questo esercizio viene apportata una piccola modifica a un articolo della documentazione open source di Microsoft Learn. Si propongono quindi le modifiche aprendo una richiesta pull.

Modificare l'articolo

  1. Accedere all'account GitHub.

  2. In una scheda del browser, passare a learn.microsoft.com/contribute/content.

  3. Nella parte superiore dell'articolo, selezionare l'icona a forma di matita Modifica.

    Screenshot dell'articolo di Collaborazione aperto e dell'icona Modifica a forma di matita evidenziata.

  4. Selezionare l'icona a forma di matita per creare una copia tramite fork di questo repository e modificarlo nel fork o modificare il file nel fork di questo progetto.

    Screenshot del file di origine dell'articolo di Collaborazione aperto in un browser e dell'icona Modifica evidenziata.

  5. Se GitHub richiede di creare una copia tramite fork del repository nella pagina successiva, selezionare Crea una copia del repository tramite fork.

  6. Verrà visualizzato il riquadro Modifica file. È necessario aggiungere una nuova frase all'inizio di questo articolo. All'inizio del secondo paragrafo, aggiungere la frase seguente: Microsoft Learn ospita tutta la documentazione per i prodotti e le tecnologie Microsoft.

    Screenshot del file di Collaborazione modificato con una nuova frase e il pulsante Commit delle modifiche evidenziato.

Aprire una richiesta pull

  1. Visualizzare in anteprima le modifiche selezionando la scheda Anteprima.

  2. Una volta completate le modifiche, trovare e selezionare Commit delle modifiche.

  3. Nel campo Messaggio di commit, digitare "TEST contributo".

    Screenshot del campo Messaggio commit compilato con il contributo TEST.

  4. Selezionare Proponi modifiche.

  5. Nella pagina Confronto modifiche, verificare che la base indichi main. Ciò significa che le modifiche verranno estratte nel ramo principale nel repository live.

    Screenshot della pagina per verificare che Base sia Main, ovvero che le modifiche verranno unite al ramo principale.

    Nota

    Se non vengono visualizzate le opzioni base repository e head repository in questa pagina, selezionare Confronto tra fork. Vengono visualizzate le opzioni di confronto necessarie per questo passaggio.

  6. Selezionare il pulsante Crea richiesta pull.

  7. Verrà visualizzata la pagina Apri una richiesta pull, in cui è possibile visualizzare in anteprima la richiesta pull.

  8. Confermare la richiesta pull e selezionare Crea richiesta pull per aprire la richiesta pull.

    Screenshot della richiesta pull aperta.

Nota

Poiché si tratta di un esercizio pratico, le modifiche non verranno applicate al sito Web live.

Congratulazioni per la creazione della richiesta pull. L'invio non è ancora stato effettuato, ma è stato completato il primo passaggio fondamentale per il contributo. Nel browser, lasciare aperta la scheda relativa alla richiesta pull. Vi si torna nell'esercizio successivo.