2019-03-27 22:30:28

by Federico Vaga

[permalink] [raw]
Subject: [PATCH] doc:it: alignement clarification about sign-off and Co-developed-by

Align Italian documentation after the following patch to the main documents

commit 24a2bb90741b docs: Clarify the usage and sign-off requirements for Co-developed-by

Signed-off-by: Federico Vaga <[email protected]>
---
.../translations/it_IT/process/5.Posting.rst | 10 +++--
.../it_IT/process/submitting-patches.rst | 41 ++++++++++++++++---
2 files changed, 42 insertions(+), 9 deletions(-)

diff --git a/Documentation/translations/it_IT/process/5.Posting.rst b/Documentation/translations/it_IT/process/5.Posting.rst
index b979266aa884..1476d51eb5e5 100644
--- a/Documentation/translations/it_IT/process/5.Posting.rst
+++ b/Documentation/translations/it_IT/process/5.Posting.rst
@@ -233,10 +233,12 @@ Le etichette in uso più comuni sono:
:ref:`Documentation/translations/it_IT/process/submitting-patches.rst <it_submittingpatches>`.
Codice che non presenta una firma appropriata non potrà essere integrato.

- - Co-developed-by: indica che la patch è stata sviluppata anche da un altro
- sviluppatore assieme all'autore originale. Questo è utile quando più
- persone lavorano sulla stessa patch. Da notare che questa persona deve
- avere anche una riga "Signed-off-by:" nella patch.
+ - Co-developed-by: indica che la patch è stata cosviluppata da diversi
+ sviluppatori; viene usato per assegnare più autori (in aggiunta a quello
+ associato all'etichetta From:) quando più persone lavorano ad una patch.
+ Ogni Co-developed-by: dev'essere seguito immediatamente da un Signed-off-by:
+ del corrispondente coautore. Maggiori dettagli ed esempi sono disponibili
+ in :ref:`Documentation/translations/it_IT/process/submitting-patches.rst <it_submittingpatches>`.

- Acked-by: indica il consenso di un altro sviluppatore (spesso il manutentore
del codice in oggetto) all'integrazione della patch nel kernel.
diff --git a/Documentation/translations/it_IT/process/submitting-patches.rst b/Documentation/translations/it_IT/process/submitting-patches.rst
index 713fba075b9d..7d7ea92c5c5a 100644
--- a/Documentation/translations/it_IT/process/submitting-patches.rst
+++ b/Documentation/translations/it_IT/process/submitting-patches.rst
@@ -567,11 +567,42 @@ alcunché - ma dovrebbe indicare che la persona ha ricevuto una copia della
patch. Questa etichetta documenta che terzi potenzialmente interessati sono
stati inclusi nella discussione.

-L'etichetta Co-developed-by: indica che la patch è stata scritta dall'autore in
-collaborazione con un altro sviluppatore. Qualche volta questo è utile quando
-più persone lavorano sulla stessa patch. Notate, questa persona deve avere
-nella patch anche una riga Signed-off-by:.
+Co-developed-by: indica che la patch è stata cosviluppata da diversi
+sviluppatori; viene usato per assegnare più autori (in aggiunta a quello
+associato all'etichetta From:) quando più persone lavorano ad una patch. Dato
+che Co-developed-by: implica la paternità della patch, ogni Co-developed-by:
+dev'essere seguito immediatamente dal Signed-off-by: del corrispondente
+coautore. Qui si applica la procedura di base per sign-off, in pratica
+l'ordine delle etichette Signed-off-by: dovrebbe riflettere il più possibile
+l'ordine cronologico della storia della patch, indipendentemente dal fatto che
+la paternità venga assegnata via From: o Co-developed-by:. Da notare che
+l'ultimo Signed-off-by: dev'essere quello di colui che ha sottomesso la patch.

+Notate anche che l'etichetta From: è opzionale quando l'autore in From: è
+anche la persona (e indirizzo email) indicato nel From: dell'intestazione
+dell'email.
+
+Esempio di una patch sottomessa dall'autore in From:::
+
+ <changelog>
+
+ Co-developed-by: First Co-Author <[email protected]>
+ Signed-off-by: First Co-Author <[email protected]>
+ Co-developed-by: Second Co-Author <[email protected]>
+ Signed-off-by: Second Co-Author <[email protected]>
+ Signed-off-by: From Author <[email protected]>
+
+Esempio di una patch sottomessa dall'autore Co-developed-by:::
+
+ From: From Author <[email protected]>
+
+ <changelog>
+
+ Co-developed-by: Random Co-Author <[email protected]>
+ Signed-off-by: Random Co-Author <[email protected]>
+ Signed-off-by: From Author <[email protected]>
+ Co-developed-by: Submitting Co-Author <[email protected]>
+ Signed-off-by: Submitting Co-Author <[email protected]>

13) Utilizzare Reported-by:, Tested-by:, Reviewed-by:, Suggested-by: e Fixes:
-----------------------------------------------------------------------------
@@ -719,7 +750,7 @@ Un paio di esempi di oggetti::
La riga ``from`` dev'essere la prima nel corpo del messaggio ed è nel
formato:

- From: Original Author <[email protected]>
+ From: Patch Author <[email protected]>

La riga ``from`` indica chi verrà accreditato nel changelog permanente come
l'autore della patch. Se la riga ``from`` è mancante, allora per determinare
--
2.20.1



2019-04-01 21:00:05

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] doc:it: alignement clarification about sign-off and Co-developed-by

On Wed, 27 Mar 2019 23:28:35 +0100
Federico Vaga <[email protected]> wrote:

> Align Italian documentation after the following patch to the main documents
>
> commit 24a2bb90741b docs: Clarify the usage and sign-off requirements for Co-developed-by
>
> Signed-off-by: Federico Vaga <[email protected]>

Applied, thanks.

jon