[PATCH] docs/zh_CN: update admin-guide/index.rst translation

[PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Yan Zhu]

update Documentation/admin-guide/index.rst Chinese translation

Update the translation through commit f0efd29aa60c
("doc: Add CPU Isolation documentation")

Signed-off-by: Yan Zhu <zhuyan2015@qq.com>
---
 .../translations/zh_CN/admin-guide/index.rst  | 209 +++++++++++++-----
 1 file changed, 159 insertions(+), 50 deletions(-)

diff --git a/Documentation/translations/zh_CN/admin-guide/index.rst b/Documentation/translations/zh_CN/admin-guide/index.rst
index 15d9ab5993a7..575449b91916 100644
--- a/Documentation/translations/zh_CN/admin-guide/index.rst
+++ b/Documentation/translations/zh_CN/admin-guide/index.rst
@@ -1,7 +1,13 @@
+.. SPDX-License-Identifier: GPL-2.0
 .. include:: ../disclaimer-zh_CN.rst
 
-:Original: :doc:`../../../admin-guide/index`
-:Translator: Alex Shi <alex.shi@linux.alibaba.com>
+:Original: Documentation/admin-guide/index.rst
+
+:翻译:
+
+ 时奎亮 Alex Shi <alex.shi@linux.alibaba.com>
+
+ 朱岩 Yan Zhu <zhuyan2015@qq.com>
 
 
 Linux 内核用户和管理员指南
@@ -11,7 +17,11 @@ Linux 内核用户和管理员指南
 整体的顺序或组织 - 这些材料不是一个单一的，连贯的文件！幸运的话，情况会随着
 时间的推移而迅速改善。
 
-这个初始部分包含总体信息，包括描述内核的README， 关于内核参数的文档等。
+
+内核管理通用指南
+----------------
+
+本节包含总体信息，包括描述内核整体的 README 文件、内核参数文档等。
 
 .. toctree::
    :maxdepth: 1
@@ -20,17 +30,55 @@ Linux 内核用户和管理员指南
 
 Todolist:
 
-*   kernel-parameters
 *   devices
+*   features
+
+内核管理接口的重要组成部分是 /proc 和 sysfs 虚拟文件系统；这些文档描述了如何
+与之交互。
+
+.. toctree::
+   :maxdepth: 1
+
+   cputopology
+
+
+Todolist:
+*   sysfs-rules
 *   sysctl/index
+*   abi
+
+安全相关文档：
+
+.. toctree::
+   :maxdepth: 1
 
-本节介绍CPU漏洞及其缓解措施。
 
 Todolist:
 
 *   hw-vuln/index
+*   LSM/index
+*   perf-security
+
+
+内核启动
+--------
+
+.. toctree::
+   :maxdepth: 1
+
+   bootconfig
+
+Todolist:
+
+*   kernel-parameters
+*   efi-stub
+*   initrd
+
+
+追踪和识别问题
+--------------
 
-下面的一组文档，针对的是试图跟踪问题和bug的用户。
+以下是一组面向试图追踪特定问题和 bug 的用户的文档。
 
 .. toctree::
    :maxdepth: 1
@@ -39,94 +87,155 @@ Todolist:
    reporting-regressions
    bug-hunting
    bug-bisect
-   tainted-kernels
    init
+   clearing-warn-once
+   lockup-watchdogs
+   sysrq
 
 Todolist:
 
+*   quickly-build-trimmed-linux
+*   verify-bugs-and-bisect-regressions
+*   tainted-kernels
 *   ramoops
 *   dynamic-debug-howto
 *   kdump/index
 *   perf/index
+*   pstore-blk
+*   kernel-per-CPU-kthreads
+*   RAS/index
+
+
+核心内核子系统
+--------------
+
+这些文档描述了核心内核管理接口，这些接口几乎在任何系统上都值得关注。
+
+.. toctree::
+   :maxdepth: 1
+
+   cpu-load
+   mm/index
+   module-signing
+   numastat
 
-这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
-方面的文档。
 
 Todolist:
 
-*   sysfs-rules
+*   cgroup-v2
+*   cgroup-v1/index
+*   namespaces/index
+*   pm/index
+*   syscall-user-dispatch
 
-本手册的其余部分包括各种指南，介绍如何根据您的喜好配置内核的特定行为。
 
+对非原生二进制格式的支持。请注意，其中一些文档相当古老。
+
+.. toctree::
+   :maxdepth: 1
+
+
+Todolist:
+
+*   binfmt-misc
+*   java
+*   mono
+
+
+块设备和文件系统管理
+--------------------
 
 .. toctree::
    :maxdepth: 1
 
-   bootconfig
-   clearing-warn-once
-   cpu-load
-   cputopology
-   lockup-watchdogs
-   numastat
-   unicode
-   sysrq
-   mm/index
 
 Todolist:
 
-*   acpi/index
-*   aoe/index
-*   auxdisplay/index
 *   bcache
 *   binderfs
-*   binfmt-misc
 *   blockdev/index
-*   braille-console
-*   btmrvl
-*   cgroup-v1/index
-*   cgroup-v2
 *   cifs/index
-*   dell_rbu
 *   device-mapper/index
-*   edid
-*   efi-stub
 *   ext4
+*   filesystem-monitoring
 *   nfs/index
-*   gpio/index
-*   highuid
-*   hw_random
-*   initrd
 *   iostats
-*   java
 *   jfs
-*   kernel-per-CPU-kthreads
+*   md
+*   ufs
+*   xfs
+
+
+专用设备指南
+------------
+
+如何在 Linux 系统中配置硬件。
+
+.. toctree::
+   :maxdepth: 1
+
+
+Todolist:
+
+*   acpi/index
+*   aoe/index
+*   auxdisplay/index
+*   braille-console
+*   btmrvl
+*   dell_rbu
+*   edid
+*   gpio/index
+*   hw_random
 *   laptops/index
 *   lcd-panel-cgram
-*   ldm
-*   LSM/index
-*   md
 *   media/index
-*   module-signing
-*   mono
-*   namespaces/index
+*   nvme-multipath
 *   parport
-*   perf-security
-*   pm/index
 *   pnp
 *   rapidio
-*   ras
 *   rtc
 *   serial-console
 *   svga
+*   thermal/index
 *   thunderbolt
-*   ufs
 *   vga-softcursor
 *   video-output
-*   xfs
+
+
+工作负载分析
+------------
+
+这是一个章节的开始，其中包含对从事 Linux 内核安全关键性分析的应用程序开发人员
+和系统集成商感兴趣的信息。这里可以找到支持分析内核与应用程序交互以及关键内核
+子系统预期的文档。
+
+.. toctree::
+   :maxdepth: 1
+
+
+Todolist:
+
+*   workload-tracing
+
+
+其他内容
+--------
+
+一些难以分类且通常已过时的文档。
+
+.. toctree::
+   :maxdepth: 1
+
+
+Todolist:
+
+*   highuid
+*   ldm
+*   unicode
 
 .. only::  subproject and html
 
-   Indices
-   =======
+   索引
+   ====
 
    * :ref:`genindex`
-- 
2.43.0

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[kernel test robot]

Hi Yan,

kernel test robot noticed the following build warnings:

[auto build test WARNING on lwn/docs-next]
[also build test WARNING on linus/master v7.1-rc3 next-20260508]
[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/Yan-Zhu/docs-zh_CN-update-admin-guide-index-rst-translation/20260511-102406
base:   git://git.lwn.net/linux.git docs-next
patch link:    https://lore.kernel.org/r/tencent_7ADF2D1EBD8EAD2028BC93BA7858EA655D0A%40qq.com
patch subject: [PATCH] docs/zh_CN: update admin-guide/index.rst translation
compiler: clang version 20.1.8 (https://github.com/llvm/llvm-project 87f0227cb60147a26a1eeb4fb06e3b505e9c7261)
docutils: docutils (Docutils 0.21.2, Python 3.13.5, on linux)
reproduce: (https://download.01.org/0day-ci/archive/20260511/202605111009.hlpiVkT6-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/202605111009.hlpiVkT6-lkp@intel.com/

All warnings (new ones prefixed by >>):

   Checksumming on output with GSO
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [docutils]
   MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]
>> Documentation/translations/zh_CN/admin-guide/index.rst:114: WARNING: toctree contains reference to nonexisting document 'translations/zh_CN/admin-guide/module-signing' [toc.not_readable]
   Documentation/userspace-api/landlock:504: ./security/landlock/errata/abi-4.h:5: ERROR: Unexpected section title.


vim +114 Documentation/translations/zh_CN/admin-guide/index.rst

   113	
 > 114	.. toctree::
   115	   :maxdepth: 1
   116	
   117	   cpu-load
   118	   mm/index
   119	   module-signing
   120	   numastat
   121	
   122	
   123	Todolist:
   124	

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

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Dongliang Mu]

On Mon, May 11, 2026 at 4:53 PM kernel test robot <lkp@intel.com> wrote:
>
> Hi Yan,
>

Hi Yan,

Please take a look at this testing report and verify if it is correct
or false alarm.

Dongliang Mu

> kernel test robot noticed the following build warnings:
>
> [auto build test WARNING on lwn/docs-next]
> [also build test WARNING on linus/master v7.1-rc3 next-20260508]
> [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/Yan-Zhu/docs-zh_CN-update-admin-guide-index-rst-translation/20260511-102406
> base:   git://git.lwn.net/linux.git docs-next
> patch link:    https://lore.kernel.org/r/tencent_7ADF2D1EBD8EAD2028BC93BA7858EA655D0A%40qq.com
> patch subject: [PATCH] docs/zh_CN: update admin-guide/index.rst translation
> compiler: clang version 20.1.8 (https://github.com/llvm/llvm-project 87f0227cb60147a26a1eeb4fb06e3b505e9c7261)
> docutils: docutils (Docutils 0.21.2, Python 3.13.5, on linux)
> reproduce: (https://download.01.org/0day-ci/archive/20260511/202605111009.hlpiVkT6-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/202605111009.hlpiVkT6-lkp@intel.com/
>
> All warnings (new ones prefixed by >>):
>
>    Checksumming on output with GSO
>    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [docutils]
>    MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]
> >> Documentation/translations/zh_CN/admin-guide/index.rst:114: WARNING: toctree contains reference to nonexisting document 'translations/zh_CN/admin-guide/module-signing' [toc.not_readable]
>    Documentation/userspace-api/landlock:504: ./security/landlock/errata/abi-4.h:5: ERROR: Unexpected section title.
>
>
> vim +114 Documentation/translations/zh_CN/admin-guide/index.rst
>
>    113
>  > 114  .. toctree::
>    115     :maxdepth: 1
>    116
>    117     cpu-load
>    118     mm/index
>    119     module-signing
>    120     numastat
>    121
>    122
>    123  Todolist:
>    124
>
> --
> 0-DAY CI Kernel Test Service
> https://github.com/intel/lkp-tests/wiki
>

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Yan Zhu]

Hi,

On 5/11/2026 4:39 PM, kernel test robot wrote:
> Hi Yan,
> 
> kernel test robot noticed the following build warnings:
> 
> [auto build test WARNING on lwn/docs-next]
> [also build test WARNING on linus/master v7.1-rc3 next-20260508]
> [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/Yan-Zhu/docs-zh_CN-update-admin-guide-index-rst-translation/20260511-102406
> base:   git://git.lwn.net/linux.git docs-next
> patch link:    https://lore.kernel.org/r/tencent_7ADF2D1EBD8EAD2028BC93BA7858EA655D0A%40qq.com
> patch subject: [PATCH] docs/zh_CN: update admin-guide/index.rst translation
> compiler: clang version 20.1.8 (https://github.com/llvm/llvm-project 87f0227cb60147a26a1eeb4fb06e3b505e9c7261)
> docutils: docutils (Docutils 0.21.2, Python 3.13.5, on linux)
> reproduce: (https://download.01.org/0day-ci/archive/20260511/202605111009.hlpiVkT6-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/202605111009.hlpiVkT6-lkp@intel.com/
> 
> All warnings (new ones prefixed by >>):
> 
>     Checksumming on output with GSO
>     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [docutils]
>     MAINTAINERS:40: WARNING: Inline strong start-string without end-string. [docutils]
>>> Documentation/translations/zh_CN/admin-guide/index.rst:114: WARNING: toctree contains reference to nonexisting document 'translations/zh_CN/admin-guide/module-signing' [toc.not_readable]
>     Documentation/userspace-api/landlock:504: ./security/landlock/errata/abi-4.h:5: ERROR: Unexpected section title.
> 

This is a false alarm. I generated a patch based on the following 
warehouse. It exists in the module-signing document:
base：git://git.kernel.org/pub/scm/linux/kernel/git/alexs/linux.git 
docs-next

Thanks for your attention.
Yan Zhu
> 
> vim +114 Documentation/translations/zh_CN/admin-guide/index.rst
> 
>     113	
>   > 114	.. toctree::
>     115	   :maxdepth: 1
>     116	
>     117	   cpu-load
>     118	   mm/index
>     119	   module-signing
>     120	   numastat
>     121	
>     122	
>     123	Todolist:
>     124	
> 
> --
> 0-DAY CI Kernel Test Service
> https://github.com/intel/lkp-tests/wiki

-- 
Yan Zhu

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Yan Zhu]

Ping.

On 5/10/2026 2:48 PM, Yan Zhu wrote:
> update Documentation/admin-guide/index.rst Chinese translation
> 
> Update the translation through commit f0efd29aa60c
> ("doc: Add CPU Isolation documentation")
> 
> Signed-off-by: Yan Zhu <zhuyan2015@qq.com>
> ---
>   .../translations/zh_CN/admin-guide/index.rst  | 209 +++++++++++++-----
>   1 file changed, 159 insertions(+), 50 deletions(-)
> 
> diff --git a/Documentation/translations/zh_CN/admin-guide/index.rst b/Documentation/translations/zh_CN/admin-guide/index.rst
> index 15d9ab5993a7..575449b91916 100644
> --- a/Documentation/translations/zh_CN/admin-guide/index.rst
> +++ b/Documentation/translations/zh_CN/admin-guide/index.rst
> @@ -1,7 +1,13 @@
> +.. SPDX-License-Identifier: GPL-2.0
>   .. include:: ../disclaimer-zh_CN.rst
>   
> -:Original: :doc:`../../../admin-guide/index`
> -:Translator: Alex Shi <alex.shi@linux.alibaba.com>
> +:Original: Documentation/admin-guide/index.rst
> +
> +:翻译:
> +
> + 时奎亮 Alex Shi <alex.shi@linux.alibaba.com>
> +
> + 朱岩 Yan Zhu <zhuyan2015@qq.com>
>   
>   
>   Linux 内核用户和管理员指南
> @@ -11,7 +17,11 @@ Linux 内核用户和管理员指南
>   整体的顺序或组织 - 这些材料不是一个单一的，连贯的文件！幸运的话，情况会随着
>   时间的推移而迅速改善。
>   
> -这个初始部分包含总体信息，包括描述内核的README， 关于内核参数的文档等。
> +
> +内核管理通用指南
> +----------------
> +
> +本节包含总体信息，包括描述内核整体的 README 文件、内核参数文档等。
>   
>   .. toctree::
>      :maxdepth: 1
> @@ -20,17 +30,55 @@ Linux 内核用户和管理员指南
>   
>   Todolist:
>   
> -*   kernel-parameters
>   *   devices
> +*   features
> +
> +内核管理接口的重要组成部分是 /proc 和 sysfs 虚拟文件系统；这些文档描述了如何
> +与之交互。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   cputopology
> +
> +
> +Todolist:
> +*   sysfs-rules
>   *   sysctl/index
> +*   abi
> +
> +安全相关文档：
> +
> +.. toctree::
> +   :maxdepth: 1
>   
> -本节介绍CPU漏洞及其缓解措施。
>   
>   Todolist:
>   
>   *   hw-vuln/index
> +*   LSM/index
> +*   perf-security
> +
> +
> +内核启动
> +--------
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   bootconfig
> +
> +Todolist:
> +
> +*   kernel-parameters
> +*   efi-stub
> +*   initrd
> +
> +
> +追踪和识别问题
> +--------------
>   
> -下面的一组文档，针对的是试图跟踪问题和bug的用户。
> +以下是一组面向试图追踪特定问题和 bug 的用户的文档。
>   
>   .. toctree::
>      :maxdepth: 1
> @@ -39,94 +87,155 @@ Todolist:
>      reporting-regressions
>      bug-hunting
>      bug-bisect
> -   tainted-kernels
>      init
> +   clearing-warn-once
> +   lockup-watchdogs
> +   sysrq
>   
>   Todolist:
>   
> +*   quickly-build-trimmed-linux
> +*   verify-bugs-and-bisect-regressions
> +*   tainted-kernels
>   *   ramoops
>   *   dynamic-debug-howto
>   *   kdump/index
>   *   perf/index
> +*   pstore-blk
> +*   kernel-per-CPU-kthreads
> +*   RAS/index
> +
> +
> +核心内核子系统
> +--------------
> +
> +这些文档描述了核心内核管理接口，这些接口几乎在任何系统上都值得关注。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   cpu-load
> +   mm/index
> +   module-signing
> +   numastat
>   
> -这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
> -方面的文档。
>   
>   Todolist:
>   
> -*   sysfs-rules
> +*   cgroup-v2
> +*   cgroup-v1/index
> +*   namespaces/index
> +*   pm/index
> +*   syscall-user-dispatch
>   
> -本手册的其余部分包括各种指南，介绍如何根据您的喜好配置内核的特定行为。
>   
> +对非原生二进制格式的支持。请注意，其中一些文档相当古老。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   binfmt-misc
> +*   java
> +*   mono
> +
> +
> +块设备和文件系统管理
> +--------------------
>   
>   .. toctree::
>      :maxdepth: 1
>   
> -   bootconfig
> -   clearing-warn-once
> -   cpu-load
> -   cputopology
> -   lockup-watchdogs
> -   numastat
> -   unicode
> -   sysrq
> -   mm/index
>   
>   Todolist:
>   
> -*   acpi/index
> -*   aoe/index
> -*   auxdisplay/index
>   *   bcache
>   *   binderfs
> -*   binfmt-misc
>   *   blockdev/index
> -*   braille-console
> -*   btmrvl
> -*   cgroup-v1/index
> -*   cgroup-v2
>   *   cifs/index
> -*   dell_rbu
>   *   device-mapper/index
> -*   edid
> -*   efi-stub
>   *   ext4
> +*   filesystem-monitoring
>   *   nfs/index
> -*   gpio/index
> -*   highuid
> -*   hw_random
> -*   initrd
>   *   iostats
> -*   java
>   *   jfs
> -*   kernel-per-CPU-kthreads
> +*   md
> +*   ufs
> +*   xfs
> +
> +
> +专用设备指南
> +------------
> +
> +如何在 Linux 系统中配置硬件。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   acpi/index
> +*   aoe/index
> +*   auxdisplay/index
> +*   braille-console
> +*   btmrvl
> +*   dell_rbu
> +*   edid
> +*   gpio/index
> +*   hw_random
>   *   laptops/index
>   *   lcd-panel-cgram
> -*   ldm
> -*   LSM/index
> -*   md
>   *   media/index
> -*   module-signing
> -*   mono
> -*   namespaces/index
> +*   nvme-multipath
>   *   parport
> -*   perf-security
> -*   pm/index
>   *   pnp
>   *   rapidio
> -*   ras
>   *   rtc
>   *   serial-console
>   *   svga
> +*   thermal/index
>   *   thunderbolt
> -*   ufs
>   *   vga-softcursor
>   *   video-output
> -*   xfs
> +
> +
> +工作负载分析
> +------------
> +
> +这是一个章节的开始，其中包含对从事 Linux 内核安全关键性分析的应用程序开发人员
> +和系统集成商感兴趣的信息。这里可以找到支持分析内核与应用程序交互以及关键内核
> +子系统预期的文档。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   workload-tracing
> +
> +
> +其他内容
> +--------
> +
> +一些难以分类且通常已过时的文档。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   highuid
> +*   ldm
> +*   unicode
>   
>   .. only::  subproject and html
>   
> -   Indices
> -   =======
> +   索引
> +   ====
>   
>      * :ref:`genindex`

-- 
Thanks
Yan Zhu

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Dongliang Mu]

On 5/10/26 2:48 PM, Yan Zhu wrote:
> update Documentation/admin-guide/index.rst Chinese translation
>
> Update the translation through commit f0efd29aa60c
> ("doc: Add CPU Isolation documentation")
>
> Signed-off-by: Yan Zhu <zhuyan2015@qq.com>
> ---
>   .../translations/zh_CN/admin-guide/index.rst  | 209 +++++++++++++-----
>   1 file changed, 159 insertions(+), 50 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/admin-guide/index.rst b/Documentation/translations/zh_CN/admin-guide/index.rst
> index 15d9ab5993a7..575449b91916 100644
> --- a/Documentation/translations/zh_CN/admin-guide/index.rst
> +++ b/Documentation/translations/zh_CN/admin-guide/index.rst
> @@ -1,7 +1,13 @@
> +.. SPDX-License-Identifier: GPL-2.0
>   .. include:: ../disclaimer-zh_CN.rst
>   
> -:Original: :doc:`../../../admin-guide/index`
> -:Translator: Alex Shi <alex.shi@linux.alibaba.com>
> +:Original: Documentation/admin-guide/index.rst
> +
> +:翻译:
> +
> + 时奎亮 Alex Shi <alex.shi@linux.alibaba.com>
> +
> + 朱岩 Yan Zhu <zhuyan2015@qq.com>
>   
>   
>   Linux 内核用户和管理员指南
> @@ -11,7 +17,11 @@ Linux 内核用户和管理员指南
>   整体的顺序或组织 - 这些材料不是一个单一的，连贯的文件！幸运的话，情况会随着
>   时间的推移而迅速改善。
>   
> -这个初始部分包含总体信息，包括描述内核的README， 关于内核参数的文档等。
> +
> +内核管理通用指南
> +----------------
> +
> +本节包含总体信息，包括描述内核整体的 README 文件、内核参数文档等。
>   
>   .. toctree::
>      :maxdepth: 1
> @@ -20,17 +30,55 @@ Linux 内核用户和管理员指南
>   
>   Todolist:
>   
> -*   kernel-parameters
>   *   devices
> +*   features
> +
> +内核管理接口的重要组成部分是 /proc 和 sysfs 虚拟文件系统；这些文档描述了如何
> +与之交互。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   cputopology
> +
> +
> +Todolist:
Add a blank line here.
> +*   sysfs-rules
>   *   sysctl/index
> +*   abi
> +
> +安全相关文档：
> +
> +.. toctree::
> +   :maxdepth: 1
>   
> -本节介绍CPU漏洞及其缓解措施。
>   
>   Todolist:
>   
>   *   hw-vuln/index
> +*   LSM/index
> +*   perf-security
> +
> +
> +内核启动
> +--------
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   bootconfig
> +
> +Todolist:
> +
> +*   kernel-parameters
> +*   efi-stub
> +*   initrd
> +
> +
> +追踪和识别问题
> +--------------
>   
> -下面的一组文档，针对的是试图跟踪问题和bug的用户。
> +以下是一组面向试图追踪特定问题和 bug 的用户的文档。
>   
>   .. toctree::
>      :maxdepth: 1
> @@ -39,94 +87,155 @@ Todolist:
>      reporting-regressions
>      bug-hunting
>      bug-bisect
> -   tainted-kernels
>      init
> +   clearing-warn-once
> +   lockup-watchdogs
> +   sysrq
>   
>   Todolist:
>   
> +*   quickly-build-trimmed-linux
> +*   verify-bugs-and-bisect-regressions
> +*   tainted-kernels
>   *   ramoops
>   *   dynamic-debug-howto
>   *   kdump/index
>   *   perf/index
> +*   pstore-blk
> +*   kernel-per-CPU-kthreads
> +*   RAS/index
> +
> +
> +核心内核子系统
> +--------------
> +
> +这些文档描述了核心内核管理接口，这些接口几乎在任何系统上都值得关注。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   cpu-load
> +   mm/index
> +   module-signing
> +   numastat
>   
> -这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
> -方面的文档。
>   
>   Todolist:
>   
> -*   sysfs-rules
> +*   cgroup-v2
> +*   cgroup-v1/index
> +*   namespaces/index
> +*   pm/index
> +*   syscall-user-dispatch
>   
> -本手册的其余部分包括各种指南，介绍如何根据您的喜好配置内核的特定行为。
>   
> +对非原生二进制格式的支持。请注意，其中一些文档相当古老。
I think you can emphasize 古老 with bold in RST, which can match the 
English documentation.
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   binfmt-misc
> +*   java
> +*   mono
> +
> +
> +块设备和文件系统管理
> +--------------------
>   
>   .. toctree::
>      :maxdepth: 1
>   
> -   bootconfig
> -   clearing-warn-once
> -   cpu-load
> -   cputopology
> -   lockup-watchdogs
> -   numastat
> -   unicode
> -   sysrq
> -   mm/index
>   
>   Todolist:
>   
> -*   acpi/index
> -*   aoe/index
> -*   auxdisplay/index
>   *   bcache
>   *   binderfs
> -*   binfmt-misc
>   *   blockdev/index
> -*   braille-console
> -*   btmrvl
> -*   cgroup-v1/index
> -*   cgroup-v2
>   *   cifs/index
> -*   dell_rbu
>   *   device-mapper/index
> -*   edid
> -*   efi-stub
>   *   ext4
> +*   filesystem-monitoring
>   *   nfs/index
> -*   gpio/index
> -*   highuid
> -*   hw_random
> -*   initrd
>   *   iostats
> -*   java
>   *   jfs
> -*   kernel-per-CPU-kthreads
> +*   md
> +*   ufs
> +*   xfs
> +
> +
> +专用设备指南
> +------------
> +
> +如何在 Linux 系统中配置硬件。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
Remove one blank line. Only keep one blank line here.
> +Todolist:
> +
> +*   acpi/index
> +*   aoe/index
> +*   auxdisplay/index
> +*   braille-console
> +*   btmrvl
> +*   dell_rbu
> +*   edid
> +*   gpio/index
> +*   hw_random
>   *   laptops/index
>   *   lcd-panel-cgram
> -*   ldm
> -*   LSM/index
> -*   md
>   *   media/index
> -*   module-signing
> -*   mono
> -*   namespaces/index
> +*   nvme-multipath
>   *   parport
> -*   perf-security
> -*   pm/index
>   *   pnp
>   *   rapidio
> -*   ras
>   *   rtc
>   *   serial-console
>   *   svga
> +*   thermal/index
>   *   thunderbolt
> -*   ufs
>   *   vga-softcursor
>   *   video-output
> -*   xfs
> +
> +
> +工作负载分析
> +------------
> +
> +这是一个章节的开始，其中包含对从事 Linux 内核安全关键性分析的应用程序开发人员
> +和系统集成商感兴趣的信息。这里可以找到支持分析内核与应用程序交互以及关键内核
> +子系统预期的文档。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
Remove one blank line. Only keep one blank line here.
> +Todolist:
> +
> +*   workload-tracing
> +
> +
> +其他内容
> +--------
> +
> +一些难以分类且通常已过时的文档。
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +
> +Todolist:
> +
> +*   highuid
> +*   ldm
> +*   unicode
>   
>   .. only::  subproject and html
>   
> -   Indices
> -   =======
> +   索引
> +   ====
>   
>      * :ref:`genindex`

Re: [PATCH] docs/zh_CN: update admin-guide/index.rst translation

[Yan Zhu]

On 5/28/2026 10:46 PM, Dongliang Mu wrote:
> 
> On 5/10/26 2:48 PM, Yan Zhu wrote:
>> update Documentation/admin-guide/index.rst Chinese translation
>>
>> Update the translation through commit f0efd29aa60c
>> ("doc: Add CPU Isolation documentation")
>>
>> Signed-off-by: Yan Zhu <zhuyan2015@qq.com>
>> ---
>>   .../translations/zh_CN/admin-guide/index.rst  | 209 +++++++++++++-----
>>   1 file changed, 159 insertions(+), 50 deletions(-)
>>
>> diff --git a/Documentation/translations/zh_CN/admin-guide/index.rst b/ 
>> Documentation/translations/zh_CN/admin-guide/index.rst
>> index 15d9ab5993a7..575449b91916 100644
>> --- a/Documentation/translations/zh_CN/admin-guide/index.rst
>> +++ b/Documentation/translations/zh_CN/admin-guide/index.rst
>> @@ -1,7 +1,13 @@
>> +.. SPDX-License-Identifier: GPL-2.0
>>   .. include:: ../disclaimer-zh_CN.rst
>> -:Original: :doc:`../../../admin-guide/index`
>> -:Translator: Alex Shi <alex.shi@linux.alibaba.com>
>> +:Original: Documentation/admin-guide/index.rst
>> +
>> +:翻译:
>> +
>> + 时奎亮 Alex Shi <alex.shi@linux.alibaba.com>
>> +
>> + 朱岩 Yan Zhu <zhuyan2015@qq.com>
>>   Linux 内核用户和管理员指南
>> @@ -11,7 +17,11 @@ Linux 内核用户和管理员指南
>>   整体的顺序或组织 - 这些材料不是一个单一的，连贯的文件！幸运的话，情 
>> 况会随着
>>   时间的推移而迅速改善。
>> -这个初始部分包含总体信息，包括描述内核的README， 关于内核参数的文档等。
>> +
>> +内核管理通用指南
>> +----------------
>> +
>> +本节包含总体信息，包括描述内核整体的 README 文件、内核参数文档等。
>>   .. toctree::
>>      :maxdepth: 1
>> @@ -20,17 +30,55 @@ Linux 内核用户和管理员指南
>>   Todolist:
>> -*   kernel-parameters
>>   *   devices
>> +*   features
>> +
>> +内核管理接口的重要组成部分是 /proc 和 sysfs 虚拟文件系统；这些文档描 
>> 述了如何
>> +与之交互。
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +   cputopology
>> +
>> +
>> +Todolist:
> Add a blank line here.

I have fixed it in patch v2.

>> +*   sysfs-rules
>>   *   sysctl/index
>> +*   abi
>> +
>> +安全相关文档：
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> -本节介绍CPU漏洞及其缓解措施。
>>   Todolist:
>>   *   hw-vuln/index
>> +*   LSM/index
>> +*   perf-security
>> +
>> +
>> +内核启动
>> +--------
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +   bootconfig
>> +
>> +Todolist:
>> +
>> +*   kernel-parameters
>> +*   efi-stub
>> +*   initrd
>> +
>> +
>> +追踪和识别问题
>> +--------------
>> -下面的一组文档，针对的是试图跟踪问题和bug的用户。
>> +以下是一组面向试图追踪特定问题和 bug 的用户的文档。
>>   .. toctree::
>>      :maxdepth: 1
>> @@ -39,94 +87,155 @@ Todolist:
>>      reporting-regressions
>>      bug-hunting
>>      bug-bisect
>> -   tainted-kernels
>>      init
>> +   clearing-warn-once
>> +   lockup-watchdogs
>> +   sysrq
>>   Todolist:
>> +*   quickly-build-trimmed-linux
>> +*   verify-bugs-and-bisect-regressions
>> +*   tainted-kernels
>>   *   ramoops
>>   *   dynamic-debug-howto
>>   *   kdump/index
>>   *   perf/index
>> +*   pstore-blk
>> +*   kernel-per-CPU-kthreads
>> +*   RAS/index
>> +
>> +
>> +核心内核子系统
>> +--------------
>> +
>> +这些文档描述了核心内核管理接口，这些接口几乎在任何系统上都值得关注。
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +   cpu-load
>> +   mm/index
>> +   module-signing
>> +   numastat
>> -这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
>> -方面的文档。
>>   Todolist:
>> -*   sysfs-rules
>> +*   cgroup-v2
>> +*   cgroup-v1/index
>> +*   namespaces/index
>> +*   pm/index
>> +*   syscall-user-dispatch
>> -本手册的其余部分包括各种指南，介绍如何根据您的喜好配置内核的特定行为。
>> +对非原生二进制格式的支持。请注意，其中一些文档相当古老。
> I think you can emphasize 古老 with bold in RST, which can match the 
> English documentation.

I have fixed it in patch v2.

>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +
>> +Todolist:
>> +
>> +*   binfmt-misc
>> +*   java
>> +*   mono
>> +
>> +
>> +块设备和文件系统管理
>> +--------------------
>>   .. toctree::
>>      :maxdepth: 1
>> -   bootconfig
>> -   clearing-warn-once
>> -   cpu-load
>> -   cputopology
>> -   lockup-watchdogs
>> -   numastat
>> -   unicode
>> -   sysrq
>> -   mm/index
>>   Todolist:
>> -*   acpi/index
>> -*   aoe/index
>> -*   auxdisplay/index
>>   *   bcache
>>   *   binderfs
>> -*   binfmt-misc
>>   *   blockdev/index
>> -*   braille-console
>> -*   btmrvl
>> -*   cgroup-v1/index
>> -*   cgroup-v2
>>   *   cifs/index
>> -*   dell_rbu
>>   *   device-mapper/index
>> -*   edid
>> -*   efi-stub
>>   *   ext4
>> +*   filesystem-monitoring
>>   *   nfs/index
>> -*   gpio/index
>> -*   highuid
>> -*   hw_random
>> -*   initrd
>>   *   iostats
>> -*   java
>>   *   jfs
>> -*   kernel-per-CPU-kthreads
>> +*   md
>> +*   ufs
>> +*   xfs
>> +
>> +
>> +专用设备指南
>> +------------
>> +
>> +如何在 Linux 系统中配置硬件。
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +
> Remove one blank line. Only keep one blank line here.
>> +Todolist:
>> +
>> +*   acpi/index
>> +*   aoe/index
>> +*   auxdisplay/index
>> +*   braille-console
>> +*   btmrvl
>> +*   dell_rbu
>> +*   edid
>> +*   gpio/index
>> +*   hw_random
>>   *   laptops/index
>>   *   lcd-panel-cgram
>> -*   ldm
>> -*   LSM/index
>> -*   md
>>   *   media/index
>> -*   module-signing
>> -*   mono
>> -*   namespaces/index
>> +*   nvme-multipath
>>   *   parport
>> -*   perf-security
>> -*   pm/index
>>   *   pnp
>>   *   rapidio
>> -*   ras
>>   *   rtc
>>   *   serial-console
>>   *   svga
>> +*   thermal/index
>>   *   thunderbolt
>> -*   ufs
>>   *   vga-softcursor
>>   *   video-output
>> -*   xfs
>> +
>> +
>> +工作负载分析
>> +------------
>> +
>> +这是一个章节的开始，其中包含对从事 Linux 内核安全关键性分析的应用程序 
>> 开发人员
>> +和系统集成商感兴趣的信息。这里可以找到支持分析内核与应用程序交互以及 
>> 关键内核
>> +子系统预期的文档。
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +
> Remove one blank line. Only keep one blank line here.

I have removed it in patch v2.

>> +Todolist:
>> +
>> +*   workload-tracing
>> +
>> +
>> +其他内容
>> +--------
>> +
>> +一些难以分类且通常已过时的文档。
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +
>> +
>> +Todolist:
>> +
>> +*   highuid
>> +*   ldm
>> +*   unicode
>>   .. only::  subproject and html
>> -   Indices
>> -   =======
>> +   索引
>> +   ====
>>      * :ref:`genindex`

-- 
Thanks
Yan Zhu