Linux Documentation
 help / color / mirror / Atom feed
* [PATCH v4] docs/ja_JP: translate submitting-patches.rst (sign-off)
@ 2026-07-19 14:20 Akiyoshi Kurita
  2026-07-19 15:18 ` Akira Yokosawa
  0 siblings, 1 reply; 3+ messages in thread
From: Akiyoshi Kurita @ 2026-07-19 14:20 UTC (permalink / raw)
  To: linux-doc; +Cc: linux-kernel, corbet, akiyks, weibu

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.

Use a reStructuredText note directive to make it clear that the note is
specific to the Japanese translation.

Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>

---
Changes in v4:

  - Use a reStructuredText note directive to clarify that the explanation
    is specific to the Japanese translation.

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.

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      | 77 +++++++++++++++++++
 1 file changed, 77 insertions(+)

diff --git a/Documentation/translations/ja_JP/process/submitting-patches.rst b/Documentation/translations/ja_JP/process/submitting-patches.rst
index d31d469909e4..2f3b6973aee7 100644
--- a/Documentation/translations/ja_JP/process/submitting-patches.rst
+++ b/Documentation/translations/ja_JP/process/submitting-patches.rst
@@ -402,3 +402,80 @@ ping したりする前に、少なくとも 1 週間は待ってください。
 パッチまたはパッチシリーズの修正版を投稿する場合は、"RESEND" を
 追加しないでください。"RESEND" は、前回の投稿から一切変更していない
 パッチまたはパッチシリーズを再送する場合にのみ使います。
+
+
+件名に PATCH を含める
+---------------------
+
+Linus と linux-kernel メーリングリストには大量のメールが届くため、
+件名の先頭に ``[PATCH]`` を付けることが一般的な慣例となっています。
+これにより、Linus や他のカーネル開発者は、パッチとその他の議論を
+容易に区別できます。
+
+``git send-email`` は、この指定を自動的に行います。
+
+
+作業への署名 - Developer's Certificate of Origin
+--------------------------------------------------
+
+誰が何を行ったのかを追跡しやすくするため、特にパッチが複数階層の
+メンテナーを経由して最終的にカーネルへ取り込まれる場合に備えて、
+メールでやり取りされるパッチには sign-off の手続きが導入されています。
+
+sign-off は、パッチの説明の末尾に追加する単純な一行です。これは、
+そのパッチを自分で作成したか、オープンソースのパッチとして提出する
+権利を持っていることを証明します。
+
+.. note:: 【訳註】
+
+   ``Signed-off-by`` によって同意する対象は、翻訳文ではなく、
+   以下に示す英語原文の Developer's Certificate of Origin 1.1 です。
+   DCO は法的な性質を持つ文書であるため、本文は翻訳せず、原文のまま
+   掲載します。内容を確認する場合は、必ず英語原文を参照してください。
+
+規則は単純で、以下を証明できる場合です::
+
+        Developer's Certificate of Origin 1.1
+
+        By making a contribution to this project, I certify that:
+
+        (a) The contribution was created in whole or in part by me and I
+            have the right to submit it under the open source license
+            indicated in the file; or
+
+        (b) The contribution is based upon previous work that, to the best
+            of my knowledge, is covered under an appropriate open source
+            license and I have the right under that license to submit that
+            work with modifications, whether created in whole or in part
+            by me, under the same open source license (unless I am
+            permitted to submit under a different license), as indicated
+            in the file; or
+
+        (c) The contribution was provided directly to me by some other
+            person who certified (a), (b) or (c) and I have not modified
+            it.
+
+        (d) I understand and agree that this project and the contribution
+            are public and that a record of the contribution (including all
+            personal information I submit with it, including my sign-off) is
+            maintained indefinitely and may be redistributed consistent with
+            this project or the open source license(s) involved.
+
+上記を証明できる場合は、次のような行を追加します::
+
+        Signed-off-by: Random J Developer <random@developer.example.org>
+
+既知の身元を使用してください。匿名での貢献は認められません。
+``git commit -s`` を使用すると、この行を自動的に追加できます。
+
+revert にも ``Signed-off-by:`` を含める必要があります。
+``git revert -s`` を使用すると、自動的に追加できます。
+
+末尾に追加のタグを付ける人もいます。現時点では無視されますが、
+社内手続きを示したり、sign-off に関する特記事項を記録したりするために
+使用できます。
+
+作者の SoB に続く追加の SoB(``Signed-off-by:``)は、パッチの開発には
+関与せず、その取り扱いや転送を行った人によるものです。SoB の連鎖は、
+パッチがメンテナーを経て最終的に Linus へ届いた実際の経路を反映する
+必要があります。最初の SoB は、単独の主要作者であることを示します。
-- 
2.52.0


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH v4] docs/ja_JP: translate submitting-patches.rst (sign-off)
  2026-07-19 14:20 [PATCH v4] docs/ja_JP: translate submitting-patches.rst (sign-off) Akiyoshi Kurita
@ 2026-07-19 15:18 ` Akira Yokosawa
  2026-07-19 17:40   ` Weijie Yuan
  0 siblings, 1 reply; 3+ messages in thread
From: Akira Yokosawa @ 2026-07-19 15:18 UTC (permalink / raw)
  To: Akiyoshi Kurita, linux-doc; +Cc: linux-kernel, corbet, Akira Yokosawa

On Sun, 19 Jul 2026 23:20:02 +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.
> 
> Use a reStructuredText note directive to make it clear that the note is
> specific to the Japanese translation.
> 
> Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
> 
> ---

Extra blank line under your SoB ...
Please remove.

> Changes in v4:
> 
>   - Use a reStructuredText note directive to clarify that the explanation
>     is specific to the Japanese translation.
> 

This patch doesn't apply cleanly on docs-next.  Please rebase.

Thanks, Akira


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH v4] docs/ja_JP: translate submitting-patches.rst (sign-off)
  2026-07-19 15:18 ` Akira Yokosawa
@ 2026-07-19 17:40   ` Weijie Yuan
  0 siblings, 0 replies; 3+ messages in thread
From: Weijie Yuan @ 2026-07-19 17:40 UTC (permalink / raw)
  To: Akira Yokosawa; +Cc: Akiyoshi Kurita, linux-doc, linux-kernel, corbet

On Mon, Jul 20, 2026 at 12:18:04AM +0900, Akira Yokosawa wrote:
> On Sun, 19 Jul 2026 23:20:02 +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.
> > 
> > Use a reStructuredText note directive to make it clear that the note is
> > specific to the Japanese translation.
> > 
> > Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
> > 
> > ---
> 
> Extra blank line under your SoB ...
> Please remove.

I remember that 'git am' would remove the blank lines between SoB and
'---' automaticly. But that said, it is better to do it well in advance.

Thanks,
Weijie

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2026-07-19 17:41 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-19 14:20 [PATCH v4] docs/ja_JP: translate submitting-patches.rst (sign-off) Akiyoshi Kurita
2026-07-19 15:18 ` Akira Yokosawa
2026-07-19 17:40   ` Weijie Yuan

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox