Condividi tramite


Panoramica della documentazione di modifica in Microsoft Learn

Grazie per l'interesse per la modifica della documentazione su Microsoft Learn. I contributi ci aiutano a garantire che la documentazione sia ben scritta, aggiornata e accurata. Le informazioni in questa pagina ti aiuteranno a decidere quale metodo di contributo è migliore per te.

Prerequisito

Prima di iniziare, assicurarsi di aver eseguito l'accesso all'account GitHub. Se non si ha un account GitHub, passare a https://github.com/join per un processo di iscrizione rapido e gratuito.

Modifiche secondarie alla documentazione

Le modifiche minime sono semplici e rapide. Esempi di modifiche minime includono:

  • Correzione degli errori di digitazioni
  • Revisione di un singolo articolo
  • Aggiunta di una sezione a un articolo
  • Correzione di un errore
  • Aggiornamento di collegamenti interrotti

Se si apportano modifiche secondarie, è sufficiente un account GitHub.

Per apportare una modifica secondaria, selezionare l'icona a forma di matita Modifica documento nella parte superiore dell'articolo. Questa azione consente di accedere al file di origine in GitHub, in cui è possibile apportare le modifiche. Al termine, verrà richiesto di creare una richiesta pull per proporre le modifiche. Per una procedura dettagliata completa di questo processo, vedere Modificare la documentazione nel browser.

Modifiche principali alla documentazione

Le principali modifiche comportano più tempo e impegno. Di seguito sono riportati alcuni esempi di modifiche importanti:

  • Modifiche complesse che richiederanno diversi giorni per il completamento
  • Revisioni a più articoli che si desidera inviare insieme
  • Creare un nuovo articolo
  • Contribuire spesso

Se si apportano modifiche importanti, è necessario scaricare e installare alcuni strumenti per semplificare il lavoro. Per iniziare, segui questa procedura:

  1. Installare gli strumenti Git e Markdown.
  2. Configurare un repository Git locale.
  3. Apportare modifiche alla documentazione.
  4. Creare una richiesta pull.

Panoramica processo

Il flusso di processo seguente illustra i passaggi generali coinvolti nell'introduzione per modifiche minori e importanti. Si noti che alcuni elementi sono passaggi una tantum, mentre altri si verificano ogni volta che si avvia un nuovo contributo.

Mappa del flusso di processo che mostra il flusso di lavoro di base per iniziare a usare il processo di contributo.

L'immagine inizia con un punto decisionale di Sta contribuendo per la prima volta? In caso affermativo, il passaggio successivo consiste nel configurare l'account GitHub. In caso contrario, il passaggio successivo è un altro punto decisionale di È minore la modifica? In caso affermativo, il passaggio successivo consiste nel modificare all'interno del browser. In caso contrario, i passaggi successivi comportano l'installazione degli strumenti di creazione, la creazione di fork e la clonazione del repository, l'apertura di una richiesta pull e la revisione e la disconnessione della richiesta pull.

Modifiche ai moduli di training

I collaboratori non possono modificare o proporre modifiche ai moduli di training. Al momento, solo la documentazione di Microsoft Learn archiviata nei repository pubblici è aperta per i contributi pubblici.