Lavora da un ramo di funzionalità, non dal tuo ramo main.¶
Prima di iniziare a lavorare sulle modifiche, assicurarsi di aver creato un
ramo. Per impostazione predefinita, quando si clona il fork del repository, il
check-out viene effettuato sul ramo main. Questo è una copia diretta del ramo
main di {{ nome_formale }}.
Sebbene sia possibile inviare una richiesta di pull dal proprio ramo main, è
preferibile non farlo. Se si invia una richiesta di pull che è quasi
corretta, il membro del core team che esamina la richiesta di pull può essere in
grado di apportare le modifiche necessarie, piuttosto che dare un feedback
chiedendo una modifica minore. Tuttavia, se si invia la richiesta di pull dal
ramo `main', ai revisori viene impedito di apportare modifiche.
Lavorare dal ramo principale rende difficile anche per lui dopo aver
completato la prima richiesta di pull. Se si vuole lavorare su una seconda
richiesta di pull, è necessario avere una copia "pulita" del ramo principale del
progetto upstream su cui basare il secondo contributo; se si è fatto il primo
contributo dal proprio ramo main, non si ha più a disposizione quella versione
pulita.
Si dovrebbero invece apportare le modifiche in un ramo di funzionalità. Un
ramo di funzionalità ha un nome semplice per identificare la modifica apportata.
Per esempio, se si sta correggendo un bug che causa problemi di compilazione su
Windows 11, si potrebbe creare un ramo di funzionalità fix-win11-build. Se il
bug si riferisce a un problema specifico che è stato segnalato, è anche comune
fare riferimento al numero del problema nel nome del ramo (ad esempio,
fix-1234).
Per creare un ramo di funzionalità fix-win11-build, eseguire:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build