Re: [PATCH v3] docs/ja_JP: translate submitting-patches.rst (sign-off)

[Akira Yokosawa]

Hi,

On Mon, 13 Jul 2026 06:05:01 +0900, Akiyoshi Kurita wrote:
> Translate the "Include PATCH in the subject" and "Sign your work -
> the Developer's Certificate of Origin" sections into Japanese.
> 
> Keep the DCO text in English as the original certificate text, and add
> a Japanese note that the sign-off refers to the English DCO text.
> 
> Signed-off-by: Akiyoshi Kurita <weibu@xxxxxxxxxxxx>
> ---
> Changes in v3:
> 
>   - Keep the DCO 1.1 text in English instead of translating it.
>   - Add a Japanese note explaining that Signed-off-by refers to the
>     original English DCO text, not to a translated version.
>   - Address Akira Yokosawa's concern about possible confusion around
>     translating the DCO text.

Looks much better.  Please see inline comment below on a cosmetic
issue.

> 
> Changes in v2:
> 
>   - Added the Japanese translation of the "Include PATCH in the subject"
>     section.
>   - Updated the DCO translation to match the current English text and
>     structure.
>   - Kept the DCO statement in a literal block following commit
>     999161066dc5.
> 
>  .../ja_JP/process/submitting-patches.rst      | 75 +++++++++++++++++++
>  1 file changed, 75 insertions(+)
> 
> diff --git a/Documentation/translations/ja_JP/process/submitting-patches.rst b/Documentation/translations/ja_JP/process/submitting-patches.rst
> index d31d469909e4..9bf4d1f99196 100644
> --- a/Documentation/translations/ja_JP/process/submitting-patches.rst
> +++ b/Documentation/translations/ja_JP/process/submitting-patches.rst
> @@ -402,3 +402,78 @@ ping したりする前に、少なくとも 1 週間は待ってください。
>  パッチまたはパッチシリーズの修正版を投稿する場合は、"RESEND" を
>  追加しないでください。"RESEND" は、前回の投稿から一切変更していない
>  パッチまたはパッチシリーズを再送する場合にのみ使います。
> +
> +
> +件名に PATCH を含める
> +---------------------
> +
> +Linus と linux-kernel メーリングリストには大量のメールが届くため、
> +件名の先頭に ``[PATCH]`` を付けることが一般的な慣例となっています。
> +これにより、Linus や他のカーネル開発者は、パッチとその他の議論を
> +容易に区別できます。
> +
> +``git send-email`` は、この指定を自動的に行います。
> +
> +
> +作業への署名 - Developer's Certificate of Origin
> +--------------------------------------------------
> +
> +誰が何を行ったのかを追跡しやすくするため、特にパッチが複数階層の
> +メンテナーを経由して最終的にカーネルへ取り込まれる場合に備えて、
> +メールでやり取りされるパッチには sign-off の手続きが導入されています。
> +
> +sign-off は、パッチの説明の末尾に追加する単純な一行です。これは、
> +そのパッチを自分で作成したか、オープンソースのパッチとして提出する
> +権利を持っていることを証明します。
> +
> +注意: ``Signed-off-by`` によって同意する対象は、翻訳文ではなく、
> +以下に示す英語原文の Developer's Certificate of Origin 1.1 です。
> +DCO は法的な性質を持つ文書であるため、本文は翻訳せず、原文のまま
> +掲載します。内容を確認する場合は、必ず英語原文を参照してください。
> +

It is not obvious that this attention note is local to ja_JP translation.
I think reST's "note" directive is useful here.  For example,

   .. note:: 【訳註】
      ``Signed-off-by`` によって同意する対象は、翻訳文ではなく、...

What do you think?

Thanks, Akira

[...]