4
pull request
omartek edited this page 2024-07-25 17:23:24 +02:00

Per fare in modo che i tuoi contributi vengano aggiunti al progetto principale (detto anche upstream) e diventino visibili sul sito, devi inviare una Pull Request, in sigla PR.

Inviare un Pull Request (PR) dal proprio branch

Appena aggiunte modifiche al tuo fork, solitamente dentro un nuovo ramo, in Gitea comparirà un avviso e un pulsante utili per inviare la richiesta di Pull Request verso l'upstream. Premi il pulsante Nuova Pull Request.

Contributo pronto da inviare tramite pull request

Nella schermata successiva, due menù a tendina ti permettono di scegliere verso quale ramo seguire il branch e quale ramo usare come fonte. Di norma a sinistra si trova il ramo main del repository del sito ed, a destra, il ramo appena creato da te per il contributo. Nella parte in basso puoi controllare tutti i tuoi nuovi contributi ed, eventualmente, confrontare le versioni dei file a cui hai apportato modifiche.

Per confermare e procedere clicca il pulsante Nuova Pull Request.

Nuova pull request

Compila la PR con un titolo (1), eventualmente usanto il prefisso WIP se trattasi di un work in progress, ed un commento (2). Opzionalmente consenti le modifiche (3) e/o aggiungi la PR ad un progetto (4).

Conferma cliccando il pulsante Crea Pull Request.

Compilazione nuova pull request

Concludere la Pull Request

Accedi ora al repository principale e verifica che una PR è stata ricevuta.

tag delle pull request

L'aggiunta delle modifiche proposte non è automatica ma richiede una successiva autorizzazione, in base alle regole scelte dall'amministratore del repository.

Il presente richiede che almeno un altro utente accetti le modifiche. Se non l'hai già fatto, seleziona l'opzione se vuoi che i maintainer possano apportare piccole modifiche.

Controlla se ricevi commenti o proposte di modifiche. Finchè la PR non viene accettata è possibile aggiungere o apportare modifiche. Ogni modifica genererà un commit, che troverai nella parte bassa della PR.

Se le modifiche richiedono tempo attiva la modalità WIP (work in progress), per evitare che qualcuno chiuda la tua PR per sbaglio.

Pulsante WIP

Quando tutto è aggiornato e qualcuno ha approvato le modifiche, vedrai una spunta verde e il pulsante Crea commit mescolato (o Create squash commit) ti permetterà di inviare tutto all'upstream. Se preferisci, appena inviata la PR e anche prima di ricevere l'approvazione di qualcuno, puoi subito richiedere il commit finale, che però resterà in stand-by e verrà eseguito automaticamente solo in seguito all'approvazione di un maintainer.

Opzione per commit squash

Tutti i tuoi commit verranno uniti in uno solo (opzione squash) e da quel momento il branch main sarà aggiornato e conterrà le modifiche da te proposte.