diff --git a/Home.md b/Home.md index 33d4f3f..d643a97 100644 --- a/Home.md +++ b/Home.md @@ -18,6 +18,7 @@ BENVENUTO NELLA WIKI * [hugo new - creare contenuti da LOCALE](hugo-new) * [Creare contenuti senza nessuno sbatti](hugo-lazyboy) * [Permalinks e struttura cartella content](struttura-content) +* [Inviare una PR - pull request](pull-request) **Link a comandi e guide per GIT** diff --git a/_Sidebar.md b/_Sidebar.md index f891894..9ee994f 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -9,6 +9,8 @@ Comandi hugo e struttura del sito * [Contribuire da LOCALE](hugo-new) * [I'm a lazy boy](hugo-lazyboy) * [Permalinks e cartella content](struttura-content) +* [Inviare una PR - pull request](pull-request) + Comandi GIT diff --git a/hugo-contrib/gitea-inviare-nuovaPR-1.png b/hugo-contrib/gitea-inviare-nuovaPR-1.png new file mode 100644 index 0000000..f45ab80 Binary files /dev/null and b/hugo-contrib/gitea-inviare-nuovaPR-1.png differ diff --git a/hugo-contrib/gitea-inviare-nuovaPR-2.png b/hugo-contrib/gitea-inviare-nuovaPR-2.png new file mode 100644 index 0000000..2230f48 Binary files /dev/null and b/hugo-contrib/gitea-inviare-nuovaPR-2.png differ diff --git a/hugo-contrib/gitea-inviare-nuovaPR-3.png b/hugo-contrib/gitea-inviare-nuovaPR-3.png new file mode 100644 index 0000000..39b7d91 Binary files /dev/null and b/hugo-contrib/gitea-inviare-nuovaPR-3.png differ diff --git a/hugo-contrib/gitea-inviare-nuovaPR-4.png b/hugo-contrib/gitea-inviare-nuovaPR-4.png new file mode 100644 index 0000000..adffe9e Binary files /dev/null and b/hugo-contrib/gitea-inviare-nuovaPR-4.png differ diff --git a/hugo-contrib/gitea-inviare-nuovaPR-5.png b/hugo-contrib/gitea-inviare-nuovaPR-5.png new file mode 100644 index 0000000..ddacdda Binary files /dev/null and b/hugo-contrib/gitea-inviare-nuovaPR-5.png differ diff --git a/hugo-new-manualmente.md b/hugo-new-manualmente.md index 3c14a3a..2bc225e 100644 --- a/hugo-new-manualmente.md +++ b/hugo-new-manualmente.md @@ -85,7 +85,7 @@ Carica gli allegati e i media se presenti. Puoi importali tutti insieme in un un ![Upload gruppo di file](hugo-contrib/gitea-aggiunta-media.png) -A questo punto il nuovo contributo è pronto per poter essere inviato cliccando il pulsante **`Nuova Pull Request`**. +A questo punto il nuovo contributo è pronto per poter essere inviato cliccando il pulsante [**`Nuova Pull Request`**](pull-request). ![Cartella pronta per la PR](hugo-contrib/gitea-PR-nuovo-contributo.png) diff --git a/pull-request.md b/pull-request.md new file mode 100644 index 0000000..8089953 --- /dev/null +++ b/pull-request.md @@ -0,0 +1,43 @@ +Per fare in modo che i tuoi contributi vengano aggiunti al progetto principale, l'**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 compariranno un avviso e un pulsante utili per inviare la richiesta di pull request verso l'upstream. + +![Contributo pronto da inviare tramite pull request](hugo-contrib/gitea-PR-nuovo-contributo.png) + +Due menù a tendina ti permettono di scegliere verso quale ramo seguire il branch e quale ramo usare come fonte. Di norma vedrai a sinistra 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](hugo-contrib/gitea-inviare-nuovaPR-1.png) + +Compila la PR con un titolo (1), eventualmente usanto il prefisso WIP se trattasi di un _work in progress_, ed un commento (2). +Opzionalmente aggiungi la PR ad un progetto (3) o consenti le modifiche (4). + +Conferma cliccando il pulsante `**Crea Pull Request**`. + +![Compilazione nuova pull request](hugo-contrib/gitea-inviare-nuovaPR-2.png) + +## Concludere la pull request + +Accedi ora al repository principale e verifica che una PR è stata ricevuta. + +![tag delle pull request](hugo-contrib/gitea-inviare-nuovaPR-3.png) + +L'aggiunta delle modifiche proposte non è automatica ma richiede una successiva autorizzazione, in base alle regole scelte dall'amministratore del repository. +Questo repository richiede che almeno un altro utente accetti le modifiche. Seleziona l'opzione se vuoi che i maintainer posso 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 potrai trovare 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](hugo-contrib/gitea-inviare-nuovaPR-4.png) + +Quando tutto è aggiornato e qualcuno ha approvato le modifiche, vedrai una spunta verde e il pulsante `Crea commit mescolato` (o `Create squash commit`) ti aggiungere tutto nell'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](hugo-contrib/gitea-inviare-nuovaPR-5.png) + +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. \ No newline at end of file