Creato articolo per pull request

omar 2024-07-25 16:15:39 +02:00
parent edf54688bb
commit 85923ba616
9 changed files with 47 additions and 1 deletions

@ -18,6 +18,7 @@ BENVENUTO NELLA WIKI
* [hugo new - creare contenuti da LOCALE](hugo-new) * [hugo new - creare contenuti da LOCALE](hugo-new)
* [Creare contenuti senza nessuno sbatti](hugo-lazyboy) * [Creare contenuti senza nessuno sbatti](hugo-lazyboy)
* [Permalinks e struttura cartella content](struttura-content) * [Permalinks e struttura cartella content](struttura-content)
* [Inviare una PR - pull request](pull-request)
**Link a comandi e guide per GIT** **Link a comandi e guide per GIT**

@ -9,6 +9,8 @@ Comandi hugo e struttura del sito
* [Contribuire da LOCALE](hugo-new) * [Contribuire da LOCALE](hugo-new)
* [I'm a lazy boy](hugo-lazyboy) * [I'm a lazy boy](hugo-lazyboy)
* [Permalinks e cartella content](struttura-content) * [Permalinks e cartella content](struttura-content)
* [Inviare una PR - pull request](pull-request)
Comandi GIT Comandi GIT

Binary file not shown.

After

Width:  |  Height:  |  Size: 156 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 169 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

@ -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) ![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) ![Cartella pronta per la PR](hugo-contrib/gitea-PR-nuovo-contributo.png)

43
pull-request.md Normal file

@ -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.