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@xxxxxx>
> > ---
> >   .../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@xxxxxxxxxxxxxxxxx>
> > +:Original: Documentation/admin-guide/index.rst
> > +
> > +:翻译:
> > +
> > + 时奎亮 Alex Shi <alex.shi@xxxxxxxxxxxxxxxxx>
> > +
> > + 朱岩 Yan Zhu <zhuyan2015@xxxxxx>
> >   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