diff options
Diffstat (limited to 'markup/pod/live-manual/media/text/it/project_contributing.ssi')
-rw-r--r-- | markup/pod/live-manual/media/text/it/project_contributing.ssi | 117 |
1 files changed, 117 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/it/project_contributing.ssi b/markup/pod/live-manual/media/text/it/project_contributing.ssi new file mode 100644 index 0000000..4144c7c --- /dev/null +++ b/markup/pod/live-manual/media/text/it/project_contributing.ssi @@ -0,0 +1,117 @@ +:B~ Contribuire al progetto + +1~contributing-to-project Contribuire al progetto + +When submitting a contribution, please clearly identify its copyright holder +and include any applicable licensing statement. Note that to be accepted, +the contribution must be licensed under the same license as the rest of the +documents, namely, GPL version 3 or later. + +I contributi al progetto, come traduzioni e patch, sono estremamente +benvenuti. Chiunque può eseguire il commit direttamente sul repository; +tuttavia chiediamo di inviare le modifiche più corpose in mailing list, per +poterne prima discutere. Per maggiori informazioni vedere la sezione +{Contatti}#contact. + +The ${project} uses Git as version control system and source code +management. As explained in {Git repositories}#git-repositories there are +two main development branches: *{debian}* and *{debian-next}*. Everybody can +commit to the debian-next branches of the live-boot, live-build, +live-config, live-images, live-manual and live-tools repositories. + +Tuttavia ci sono alcune restrizioni. Il server rifiuta: + +_* push non fast-forward, + +_* commit merge, + +_* aggiunta o rimozione di tag e branch. + +Anche se tutti i commit possono essere corretti, chiediamo di usare il buon +senso ed eseguire buoni commit con dei buoni messaggi. + +_* Si scrivano messaggi costituiti da frasi in inglese esaurienti e utili, +inizianti con una lettera maiuscola e terminanti con un punto. Solitamente +cominceranno con la forma +"Fixing/Adding/Removing/Correcting/Translating/...". + +_* Scrivere buoni messaggi nei commmit. La prima riga deve contenere un +sunto accurato del contenuto del commit in quanto verrà incluso nel +changelog. Se si necessita di aggiungere ulteriori spiegazioni, scriverle +sotto lasciando una riga vuota dopo la prima e quindi un'altra vuota dopo +ogni paragrafo. Le righe non devono superare gli 80 caratteri. + +_* Eseguire commit atomici, ovvero non mescolare cose non inerenti tra loro +nello stesso commit ma farne uno per ogni modifica apportata. + +2~ Applicare le modifiche + +Per eseguire il push ai repository è necessario seguire la seguente +procedura. Verrà usato live-manual come esempio per cui rimpiazzalo con il +nome del repository su cui si vuole lavorare. Per informazioni dettagliare +su come modificare live-manual si veda {Contribuire a questo +documento}#how-to-contribute. + +_* Prelevare la chiave pubblica: + +code{ + + $ mkdir -p ~/.ssh/keys + $ wget http://live-systems.org/other/keys/git@live-systems.org -O ~/.ssh/keys/git@live-systems.org + $ wget http://live-systems.org/other/keys/git@live-systems.org.pub -O ~/.ssh/keys/git@live-systems.org.pub + $ chmod 0600 ~/.ssh/keys/git@live-systems.org* + +}code + +_* Aggiungere la seguente sezione alla propria configurazione di +openssh-client: + +code{ + + $ cat >> ~/.ssh/config << EOF + Host live-systems.org + Hostname live-systems.org + User git + IdentitiesOnly yes + IdentityFile ~/.ssh/keys/git@live-systems.org + EOF + +}code + +_* Scaricare tramite ssh un clone del manuale: + +code{ + + $ git clone git@live-systems.org:/live-manual.git + $ cd live-manual && git checkout debian-next + +}code + +_* Assicurarsi di avere impostato autore e indirizzo email: + +code{ + + $ git config user.name "John Doe" + $ git config user.email john@example.org + +}code + +*{Importante:}* Notare che tutte le modifiche vanno eseguite sul ramo *{debian-next}*. + +_* Apportare le modifiche. In questo esempio si scrive prima una nuova +sezione che si occupa di applicare patch e quindi prepararla al commit +aggiungendo i file e scrivendo il messaggio in questo modo: + +code{ + + $ git commit -a -m "Adding a section on applying patches." + +}code + +_* Inviare il commit al server: + +code{ + + $ git push + +}code |