[PATCH] docs/ja_JP: translate submitting-patches.rst (review and report tags)

[PATCH] docs/ja_JP: translate submitting-patches.rst (review and report tags)

[Akiyoshi Kurita]

Translate the section describing Reported-by, Tested-by, Reviewed-by,
Suggested-by, and Fixes tags into Japanese.

This includes the Reviewer's Statement and the guidance on adding or
removing review and testing tags in subsequent patch versions.

Keep the Japanese submitting-patches documentation aligned with the
corresponding English section.

Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
---
 .../ja_JP/process/submitting-patches.rst      | 91 +++++++++++++++++++
 1 file changed, 91 insertions(+)

diff --git a/Documentation/translations/ja_JP/process/submitting-patches.rst b/Documentation/translations/ja_JP/process/submitting-patches.rst
index 797b70b97fa7..0b4e22b015d7 100644
--- a/Documentation/translations/ja_JP/process/submitting-patches.rst
+++ b/Documentation/translations/ja_JP/process/submitting-patches.rst
@@ -573,3 +573,94 @@ Acked-by:、Cc:、Co-developed-by: を使用する場合
     Signed-off-by: From Author <from@author.example.org>
     Co-developed-by: Submitting Co-Author <sub@coauthor.example.org>
     Signed-off-by: Submitting Co-Author <sub@coauthor.example.org>
+
+
+Reported-by:、Tested-by:、Reviewed-by:、Suggested-by:、Fixes: の使用
+---------------------------------------------------------------------
+
+``Reported-by:`` タグは、バグを発見して報告した人の功績を示すものであり、
+今後も再び協力してもらうきっかけになることが期待されます。このタグは
+バグを対象としています。機能追加の要望に対する功績を示すためには
+使用しないでください。報告が Web 上で参照できない場合を除き、
+``Reported-by:`` タグの後には、その報告を指す ``Closes:`` タグを
+付ける必要があります。パッチが報告された問題の一部だけを修正する場合は、
+``Closes:`` の代わりに ``Link:`` タグを使用できます。なお、
+``Reported-by:`` は、名前を記載される本人の明示的な許可なしに
+使用できる可能性がある三つのタグのうちの一つです。詳細については、
+後述の「人をタグ付けするには許可が必要」を参照してください。
+
+``Tested-by:`` タグは、記載された人が（何らかの環境で）パッチを
+正常にテストしたことを示します。このタグは、何らかのテストが
+実施されたことをメンテナーに知らせ、将来のパッチでテスターを
+探す手段を提供するとともに、テスターの功績を記録します。
+
+一方、``Reviewed-by:`` は、パッチがレビューされ、以下の
+レビュー担当者の声明に従って受け入れ可能と判断されたことを示します::
+
+        レビュー担当者による確認声明
+
+        ``Reviewed-by:`` タグを付けることにより、私は以下を表明します:
+
+         (a) このパッチがメインラインカーネルへの取り込みに適切であり、
+             その準備が整っているかを評価するため、技術的なレビューを
+             行いました。
+
+         (b) パッチに関する問題、懸念、または質問はすべて提出者に
+             伝えられています。私は、自分のコメントに対する提出者の
+             回答に満足しています。
+
+         (c) この提出物には改善できる点が残っている可能性がありますが、
+             現時点では、(1) カーネルに対する価値のある変更であり、
+             (2) 取り込みに反対する理由となる既知の問題がないと
+             考えています。
+
+         (d) 私はこのパッチをレビューし、妥当であると考えていますが、
+             別途明示されていない限り、そのパッチが記載された目的を
+             達成すること、またはいかなる状況でも正しく動作することを
+             保証するものではありません。
+
+``Reviewed-by:`` タグは、そのパッチが重大な技術的問題を残していない、
+カーネルに対する適切な変更であるという意見を表明するものです。
+必要なレビューを行った既知の身元を持つ人であれば、関心のある
+レビュー担当者は誰でもパッチに ``Reviewed-by:`` タグを付けられます。
+このタグは、レビュー担当者の功績を示すとともに、どの程度のレビューが
+行われたかをメンテナーに知らせる役割を果たします。対象分野を理解し、
+十分なレビューを行うことで知られているレビュー担当者が付けた
+``Reviewed-by:`` タグは、通常、パッチがカーネルに取り込まれる
+可能性を高めます。
+
+``Tested-by:`` と ``Reviewed-by:`` の両方のタグは、メーリングリスト上で
+テスターまたはレビュー担当者から受け取った後、次のバージョンを
+送信するときに、作者が該当するパッチへ追加する必要があります。
+ただし、次のバージョンでパッチが大幅に変更された場合は、これらのタグが
+適用できなくなる可能性があるため、削除する必要があります。
+通常、誰かの ``Acked-by:``、``Tested-by:``、または ``Reviewed-by:`` タグを
+削除した場合は、その理由をパッチの変更履歴で説明する必要があります
+（``---`` 区切りの後）。
+
+``Suggested-by:`` タグは、パッチのアイデアが記載された人によって
+提案されたことを示し、そのアイデアに対する功績を記録します。
+アイデアを提案した人の功績をきちんと記録すれば、今後も再び協力して
+もらうきっかけになることが期待されます。なお、これは、名前を
+記載される本人の明示的な許可なしに使用できる可能性がある三つの
+タグのうちの一つです。詳細については、後述の
+「人をタグ付けするには許可が必要」を参照してください。
+
+``Fixes:`` タグは、そのパッチが以前のコミットにあるバグを修正する
+ことを示します。これは、問題がどこで発生したのかを容易に特定できる
+ようにし、バグ修正のレビューに役立ちます。また、このタグは stable
+kernel チームが、どの stable kernel バージョンに修正を適用すべきかを
+判断する際にも役立ちます。パッチが修正するバグを示す方法としては、
+これが推奨されています。詳細については :ref:`describe_changes` を
+参照してください。
+
+注意: ``Fixes:`` タグを付けても、stable kernel rules の手順や、
+stable 向けパッチ候補すべてで ``Cc: stable@vger.kernel.org`` を
+指定する要件がなくなるわけではありません。詳細については、
+Documentation/process/stable-kernel-rules.rst を参照してください。
+
+最後に、タグを付けることは歓迎され、通常は非常にありがたいものですが、
+署名者（すなわち、提出者およびメンテナー）は、提示されたタグを
+適用するかどうかを自身の判断で決めることができます。
+
+.. _tagging_people:
-- 
2.52.0

Re: [PATCH] docs/ja_JP: translate submitting-patches.rst (review and report tags)

[Akira Yokosawa]

Hi Kurita-san,

First of all, this email has a lot of bogus @www.redadmin.org addresses
in To: and Cc:.  Please don't do that.

On 9/3/26 11:03, Akiyoshi Kurita wrote:
> Translate the section describing Reported-by, Tested-by, Reviewed-by,
> Suggested-by, and Fixes tags into Japanese.
> 
> This includes the Reviewer's Statement and the guidance on adding or
> removing review and testing tags in subsequent patch versions.
> 
> Keep the Japanese submitting-patches documentation aligned with the
> corresponding English section.

Inline comments below.

> 
> Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
> ---
>  .../ja_JP/process/submitting-patches.rst      | 91 +++++++++++++++++++
>  1 file changed, 91 insertions(+)
> 
> diff --git a/Documentation/translations/ja_JP/process/submitting-patches.rst b/Documentation/translations/ja_JP/process/submitting-patches.rst
> index 797b70b97fa7..0b4e22b015d7 100644
> --- a/Documentation/translations/ja_JP/process/submitting-patches.rst
> +++ b/Documentation/translations/ja_JP/process/submitting-patches.rst
> @@ -573,3 +573,94 @@ Acked-by:、Cc:、Co-developed-by: を使用する場合
>      Signed-off-by: From Author <from@author.example.org>
>      Co-developed-by: Submitting Co-Author <sub@coauthor.example.org>
>      Signed-off-by: Submitting Co-Author <sub@coauthor.example.org>
> +
> +
> +Reported-by:、Tested-by:、Reviewed-by:、Suggested-by:、Fixes: の使用
> +---------------------------------------------------------------------
> +
> +``Reported-by:`` タグは、バグを発見して報告した人の功績を示すものであり、
> +今後も再び協力してもらうきっかけになることが期待されます。このタグは
> +バグを対象としています。機能追加の要望に対する功績を示すためには
> +使用しないでください。報告が Web 上で参照できない場合を除き、
> +``Reported-by:`` タグの後には、その報告を指す ``Closes:`` タグを
> +付ける必要があります。パッチが報告された問題の一部だけを修正する場合は、

   付けてください。報告された問題の一部だけを修正するパッチの場合は、

> +``Closes:`` の代わりに ``Link:`` タグを使用できます。なお、
> +``Reported-by:`` は、名前を記載される本人の明示的な許可なしに
> +使用できる可能性がある三つのタグのうちの一つです。詳細については、
> +後述の「人をタグ付けするには許可が必要」を参照してください。
> +
> +``Tested-by:`` タグは、記載された人が（何らかの環境で）パッチを
> +正常にテストしたことを示します。このタグは、何らかのテストが
> +実施されたことをメンテナーに知らせ、将来のパッチでテスターを
> +探す手段を提供するとともに、テスターの功績を記録します。
> +
> +一方、``Reviewed-by:`` は、パッチがレビューされ、以下の
> +レビュー担当者の声明に従って受け入れ可能と判断されたことを示します::
> +
> +        レビュー担当者による確認声明

You used "レビューア" for "reviewer" in your earlier submissions.
Is there any reason for the different word/term ?

Also, "Reviewer's statement of oversight" is similar to the DCO.
I think it should be translated in a way so that it looks like
a legal statement.
Especially, I'd use "だ体", or formal style.

I would rather put the original English text here, and append the
translation as a 試訳 (or 訳例).

> +
> +        ``Reviewed-by:`` タグを付けることにより、私は以下を表明します:
> +
> +         (a) このパッチがメインラインカーネルへの取り込みに適切であり、
> +             その準備が整っているかを評価するため、技術的なレビューを
> +             行いました。
> +
> +         (b) パッチに関する問題、懸念、または質問はすべて提出者に
> +             伝えられています。私は、自分のコメントに対する提出者の
> +             回答に満足しています。
> +
> +         (c) この提出物には改善できる点が残っている可能性がありますが、
> +             現時点では、(1) カーネルに対する価値のある変更であり、
> +             (2) 取り込みに反対する理由となる既知の問題がないと
> +             考えています。
> +
> +         (d) 私はこのパッチをレビューし、妥当であると考えていますが、
> +             別途明示されていない限り、そのパッチが記載された目的を
> +             達成すること、またはいかなる状況でも正しく動作することを
> +             保証するものではありません。
> +
> +``Reviewed-by:`` タグは、そのパッチが重大な技術的問題を残していない、
> +カーネルに対する適切な変更であるという意見を表明するものです。
> +必要なレビューを行った既知の身元を持つ人であれば、関心のある
> +レビュー担当者は誰でもパッチに ``Reviewed-by:`` タグを付けられます。
> +このタグは、レビュー担当者の功績を示すとともに、どの程度のレビューが
> +行われたかをメンテナーに知らせる役割を果たします。対象分野を理解し、
> +十分なレビューを行うことで知られているレビュー担当者が付けた
> +``Reviewed-by:`` タグは、通常、パッチがカーネルに取り込まれる
> +可能性を高めます。
> +
> +``Tested-by:`` と ``Reviewed-by:`` の両方のタグは、メーリングリスト上で
> +テスターまたはレビュー担当者から受け取った後、次のバージョンを
> +送信するときに、作者が該当するパッチへ追加する必要があります。
> +ただし、次のバージョンでパッチが大幅に変更された場合は、これらのタグが
> +適用できなくなる可能性があるため、削除する必要があります。
> +通常、誰かの ``Acked-by:``、``Tested-by:``、または ``Reviewed-by:`` タグを
> +削除した場合は、その理由をパッチの変更履歴で説明する必要があります
> +（``---`` 区切りの後）。
> +
> +``Suggested-by:`` タグは、パッチのアイデアが記載された人によって
> +提案されたことを示し、そのアイデアに対する功績を記録します。
> +アイデアを提案した人の功績をきちんと記録すれば、今後も再び協力して
> +もらうきっかけになることが期待されます。なお、これは、名前を
> +記載される本人の明示的な許可なしに使用できる可能性がある三つの
> +タグのうちの一つです。詳細については、後述の
> +「人をタグ付けするには許可が必要」を参照してください。
> +
> +``Fixes:`` タグは、そのパッチが以前のコミットにあるバグを修正する
> +ことを示します。これは、問題がどこで発生したのかを容易に特定できる
> +ようにし、バグ修正のレビューに役立ちます。また、このタグは stable
> +kernel チームが、どの stable kernel バージョンに修正を適用すべきかを
> +判断する際にも役立ちます。パッチが修正するバグを示す方法としては、
> +これが推奨されています。詳細については :ref:`describe_changes` を

This will point the original (English) section.  File-local reference
can be made by:

                        詳細については `変更内容を記述する`_ を

> +参照してください。
> +
> +注意: ``Fixes:`` タグを付けても、stable kernel rules の手順や、
> +stable 向けパッチ候補すべてで ``Cc: stable@vger.kernel.org`` を
> +指定する要件がなくなるわけではありません。詳細については、
> +Documentation/process/stable-kernel-rules.rst を参照してください。
> +
> +最後に、タグを付けることは歓迎され、通常は非常にありがたいものですが、
> +署名者（すなわち、提出者およびメンテナー）は、提示されたタグを
> +適用するかどうかを自身の判断で決めることができます。

This label is not needed in this patch/file ...

> +
> +.. _tagging_people:

Thanks, Akira

Re: [PATCH] docs/ja_JP: translate submitting-patches.rst (review and report tags)

[kernel test robot]

Hi Akiyoshi,

kernel test robot noticed the following build warnings:

[auto build test WARNING on lwn/docs-next]
[also build test WARNING on linus/master v7.3-rc2 next-20260902]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]

url:    https://github.com/intel-lab-lkp/linux/commits/Akiyoshi-Kurita/docs-ja_JP-translate-submitting-patches-rst-review-and-report-tags/20260903-110356
base:   git://git.lwn.net/linux.git docs-next
patch link:    https://lore.kernel.org/r/20260903020356.1055420-1-weibu%40redadmin.org
patch subject: [PATCH] docs/ja_JP: translate submitting-patches.rst (review and report tags)
compiler: clang version 22.1.8 (https://github.com/llvm/llvm-project ca7933e47d3a3451d81e72ac174dcb5aa28b59d1)
docutils: docutils (Docutils 0.21.2, Python 3.13.5, on linux)
reproduce: (https://download.01.org/0day-ci/archive/20260907/202609071452.EmRYk0Iq-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202609071452.EmRYk0Iq-lkp@intel.com/

All warnings (new ones prefixed by >>):

   Relational referents
   ~~~~~~~~~~~~~~~~~~~~~ [docutils]
>> Documentation/translations/ja_JP/process/submitting-patches.rst:666: WARNING: duplicate label tagging_people, other instance in Documentation/process/submitting-patches.rst
   Documentation/userspace-api/landlock:572: ./security/landlock/errata/abi-4.h:5: ERROR: Unexpected section title.


vim +666 Documentation/translations/ja_JP/process/submitting-patches.rst

   665	
 > 666	.. _tagging_people:

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki

[PATCH v2] docs/ja_JP: translate submitting-patches.rst (review and report tags)

[Akiyoshi Kurita]

Translate the section describing Reported-by, Tested-by, Reviewed-by,
Suggested-by, and Fixes tags into Japanese.

This includes the Reviewer's Statement and the guidance on adding or
removing review and testing tags in subsequent patch versions.

Keep the Japanese submitting-patches documentation aligned with the
corresponding English section.

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

Changes in v2:

  - Use "レビューア" consistently for "reviewer".
  - Keep the Reviewer's Statement in English and add a Japanese
    tentative translation in a formal style.
  - Reword the Reported-by description as suggested.
  - Use a file-local reference for "変更内容を記述する".
  - Drop the duplicate tagging_people label.


 .../ja_JP/process/submitting-patches.rst      | 116 ++++++++++++++++++
 1 file changed, 116 insertions(+)

diff --git a/Documentation/translations/ja_JP/process/submitting-patches.rst b/Documentation/translations/ja_JP/process/submitting-patches.rst
index 797b70b97fa7..dfc5500f420d 100644
--- a/Documentation/translations/ja_JP/process/submitting-patches.rst
+++ b/Documentation/translations/ja_JP/process/submitting-patches.rst
@@ -573,3 +573,119 @@ Acked-by:、Cc:、Co-developed-by: を使用する場合
     Signed-off-by: From Author <from@author.example.org>
     Co-developed-by: Submitting Co-Author <sub@coauthor.example.org>
     Signed-off-by: Submitting Co-Author <sub@coauthor.example.org>
+
+
+Reported-by:、Tested-by:、Reviewed-by:、Suggested-by:、Fixes: の使用
+---------------------------------------------------------------------
+
+``Reported-by:`` タグは、バグを発見して報告した人の功績を示すものであり、
+今後も再び協力してもらうきっかけになることが期待されます。このタグは
+バグを対象としています。機能追加の要望に対する功績を示すためには
+使用しないでください。報告が Web 上で参照できない場合を除き、
+``Reported-by:`` タグの後には、その報告を指す ``Closes:`` タグを
+付けてください。報告された問題の一部だけを修正するパッチの場合は、
+``Closes:`` の代わりに ``Link:`` タグを使用できます。なお、
+``Reported-by:`` は、名前を記載される本人の明示的な許可なしに
+使用できる可能性がある三つのタグのうちの一つです。詳細については、
+後述の「人をタグ付けするには許可が必要」を参照してください。
+
+``Tested-by:`` タグは、記載された人が（何らかの環境で）パッチを
+正常にテストしたことを示します。このタグは、何らかのテストが
+実施されたことをメンテナーに知らせ、将来のパッチでテスターを
+探す手段を提供するとともに、テスターの功績を記録します。
+
+一方、``Reviewed-by:`` は、パッチがレビューされ、以下の
+レビューアの声明に従って受け入れ可能と判断されたことを示します。
+
+Reviewer's statement of oversight
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+By offering my Reviewed-by: tag, I state that:
+
+        (a) I have carried out a technical review of this patch to
+            evaluate its appropriateness and readiness for inclusion into
+            the mainline kernel.
+
+        (b) Any problems, concerns, or questions relating to the patch
+            have been communicated back to the submitter.  I am satisfied
+            with the submitter's response to my comments.
+
+        (c) While there may be things that could be improved with this
+            submission, I believe that it is, at this time, (1) a
+            worthwhile modification to the kernel, and (2) free of known
+            issues which would argue against its inclusion.
+
+        (d) While I have reviewed the patch and believe it to be sound, I
+            do not (unless explicitly stated elsewhere) make any
+            warranties or guarantees that it will achieve its stated
+            purpose or function properly in any given situation.
+
+.. note::
+
+   〖試訳〗
+
+   **レビューアによる確認声明**
+
+   ``Reviewed-by:`` タグを付けることにより、私は以下を表明する。
+
+   (a) このパッチがメインラインカーネルへの取り込みに適切であり、
+       その準備が整っているかを評価するため、技術的なレビューを
+       実施した。
+
+   (b) パッチに関する問題、懸念、または質問はすべて提出者に
+       伝えられている。私は、自分のコメントに対する提出者の
+       回答に満足している。
+
+   (c) この提出物には改善できる点が残っている可能性があるが、
+       現時点において、(1) カーネルに対する価値のある変更であり、
+       かつ (2) その取り込みに反対する理由となる既知の問題が
+       存在しないと考える。
+
+   (d) 私はこのパッチをレビューし、妥当であると考えているが、
+       別途明示されていない限り、そのパッチが記載された目的を
+       達成すること、またはいかなる状況においても正しく動作する
+       ことについて、いかなる保証も行わない。
+
+``Reviewed-by:`` タグは、そのパッチが重大な技術的問題を残していない、
+カーネルに対する適切な変更であるという意見を表明するものです。
+必要なレビューを行った既知の身元を持つ人であれば、関心のある
+レビューアは誰でもパッチに ``Reviewed-by:`` タグを付けられます。
+このタグは、レビューアの功績を示すとともに、どの程度のレビューが
+行われたかをメンテナーに知らせる役割を果たします。対象分野を理解し、
+十分なレビューを行うことで知られているレビューアが付けた
+``Reviewed-by:`` タグは、通常、パッチがカーネルに取り込まれる
+可能性を高めます。
+
+``Tested-by:`` と ``Reviewed-by:`` の両方のタグは、メーリングリスト上で
+テスターまたはレビューアから受け取った後、次のバージョンを
+送信するときに、作者が該当するパッチへ追加する必要があります。
+ただし、次のバージョンでパッチが大幅に変更された場合は、これらのタグが
+適用できなくなる可能性があるため、削除する必要があります。
+通常、誰かの ``Acked-by:``、``Tested-by:``、または ``Reviewed-by:`` タグを
+削除した場合は、その理由をパッチの変更履歴で説明する必要があります
+（``---`` 区切りの後）。
+
+``Suggested-by:`` タグは、パッチのアイデアが記載された人によって
+提案されたことを示し、そのアイデアに対する功績を記録します。
+アイデアを提案した人の功績をきちんと記録すれば、今後も再び協力して
+もらうきっかけになることが期待されます。なお、これは、名前を
+記載される本人の明示的な許可なしに使用できる可能性がある三つの
+タグのうちの一つです。詳細については、後述の
+「人をタグ付けするには許可が必要」を参照してください。
+
+``Fixes:`` タグは、そのパッチが以前のコミットにあるバグを修正する
+ことを示します。これは、問題がどこで発生したのかを容易に特定できる
+ようにし、バグ修正のレビューに役立ちます。また、このタグは stable
+kernel チームが、どの stable kernel バージョンに修正を適用すべきかを
+判断する際にも役立ちます。パッチが修正するバグを示す方法としては、
+これが推奨されています。詳細については `変更内容を記述する`_ を
+参照してください。
+
+注意: ``Fixes:`` タグを付けても、stable kernel rules の手順や、
+stable 向けパッチ候補すべてで ``Cc: stable@vger.kernel.org`` を
+指定する要件がなくなるわけではありません。詳細については、
+Documentation/process/stable-kernel-rules.rst を参照してください。
+
+最後に、タグを付けることは歓迎され、通常は非常にありがたいものですが、
+署名者（すなわち、提出者およびメンテナー）は、提示されたタグを
+適用するかどうかを自身の判断で決めることができます。

base-commit: d793bcfca6bb493eb8e93900285f951a0c9dbf7c
-- 
2.52.0