Esplorare il flusso di GitHub
GitHub è lo strumento migliore per abilitare la collaborazione nei progetti. Il flusso di GitHub è un flusso di lavoro basato su rami consigliato per GitHub.
Nota
Per implementare il flusso GitHub, sono necessari un account GitHub e un repository. Vedere "Iscriversi a GitHub" e "Creare un repository".
Suggerimento
È possibile completare tutti i passaggi del flusso di GitHub tramite l'interfaccia web di GitHub, la riga di comando, GitHub CLIo GitHub Desktop.
Il primo passaggio consiste nel creare un ramo nel repository per funzionare senza influire sul ramo predefinito e fornire ai collaboratori la possibilità di esaminare il lavoro.
Per altre informazioni, vedere "Creazione ed eliminazione di rami all'interno del repository".
Apportare le modifiche desiderate al repository. Se si commette un errore, è possibile ripristinare o apportare modifiche aggiuntive per correggerlo.
Esegui il commit e il push delle tue modifiche nel ramo per salvare il lavoro nell'archiviazione remota, fornendo a ogni commit un messaggio descrittivo. Ogni commit deve contenere una modifica isolata e completa che semplifica il ripristino se si usa un approccio diverso.
Chiunque collabora con il progetto possa visualizzare il lavoro, rispondere alle domande e inviare suggerimenti o contributi. Continuare a creare, eseguire il commit e il push delle modifiche nel ramo fino a quando non si è pronti a richiedere commenti e suggerimenti.
Suggerimento
È possibile creare un ramo separato per ogni modifica per rendere più semplice per i revisori fornire commenti e suggerimenti o per comprendere le differenze.
Una volta pronti, è possibile creare una richiesta pull per chiedere ai collaboratori commenti e suggerimenti sulle modifiche. Consulta "Creazione di una richiesta pull".
La revisione delle richieste pull è una delle funzionalità più importanti della collaborazione. È possibile richiedere l'approvazione da parte dei colleghi e del team prima di unire le modifiche. Inoltre, è possibile contrassegnarlo come bozza nel caso in cui si vogliano commenti o consigli iniziali prima di completare le modifiche.
Descrivi il pull request il più dettagliatamente possibile, includendo le modifiche suggerite e il problema che stai risolvendo. È possibile aggiungere immagini, collegamenti, problemi correlati o qualsiasi informazione per documentare la modifica e aiutare i revisori a comprendere il PR senza dover aprire ogni singolo file. Vedere "sintassi di scrittura e formattazione di base" e "Collegamento di una richiesta pull a un problema".
Un altro modo per migliorare la qualità della pull request e la documentazione, e indicare in modo esplicito un elemento ai revisori, consiste nell'usare l'area della sezione dei commenti. Inoltre, puoi @mention o richiedere una revisione da parte di persone o team specifici.
Esistono altre configurazioni delle richieste pull, come richiedere automaticamente una verifica a team o utenti specifici quando viene creata una richiesta pull o eseguire controlli sulle richieste pull. Per altre informazioni, vedere "Informazioni sui controlli di stato" e "Informazioni sui rami protetti".
Dopo i commenti e la convalida dei controlli da parte dei revisori, le modifiche dovrebbero essere pronte per essere unite, e possono così approvare il Pull Request. Consultare unire una richiesta pull.
In caso di conflitti, GitHub informerà l'utente per risolverli. "Risoluzione dei conflitti di unione."
Dopo la fusione di una richiesta pull riuscita, non è necessario che il ramo remoto rimanga presente. È possibile eliminare il ramo per impedire ad altri utenti di usare accidentalmente i rami precedenti. Per altre informazioni, vedere "Eliminazione e ripristino di rami in una richiesta pull".
Nota
GitHub mantiene la cronologia di commit e merge qualora sia necessario ripristinare o annullare la pull request.