[PATCH 0/4] docs/zh_CN: Rewrite the zh_CN/index.rst

[PATCH 0/4] docs/zh_CN: Rewrite the zh_CN/index.rst

[Wu XiangCheng]

Follow Jonathan's steps[1], rewrite the entry point of kernel's Chinese
translation documentation.

Thanks,

[1]: https://lore.kernel.org/linux-doc/20220927160559.97154-1-corbet@lwn.net/T

Wu XiangCheng (4):
  docs/zh_CN: promote the title of zh_CN/process/index.rst
  docs/zh_CN: add zh_CN/arch.rst
  docs/zh_CN: Rewrite the Chinsese translation front page
  docs/zh_CN: add a man-pages link to zh_CN/index.rst

 Documentation/translations/zh_CN/arch.rst     |  30 ++++
 Documentation/translations/zh_CN/index.rst    | 169 ++++++------------
 .../translations/zh_CN/process/index.rst      |   1 +
 3 files changed, 83 insertions(+), 117 deletions(-)
 create mode 100644 Documentation/translations/zh_CN/arch.rst


base-commit: 05fff6ba04eef8b88bb94734b66731bef3d8d34b
-- 
2.30.2


-- 
Wu XiangCheng	0x32684A40BCA7AEA7

[PATCH 1/4] docs/zh_CN: promote the title of zh_CN/process/index.rst

[Wu XiangCheng]

From: Wu XiangCheng <bobwxc@email.cn>

update to commit 9d0f5cd16744 ("docs: promote the title of
process/index.rst")

Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
 Documentation/translations/zh_CN/process/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/translations/zh_CN/process/index.rst b/Documentation/translations/zh_CN/process/index.rst
index a683dbea0c83..a1a35f88f4ae 100644
--- a/Documentation/translations/zh_CN/process/index.rst
+++ b/Documentation/translations/zh_CN/process/index.rst
@@ -10,6 +10,7 @@
 
 .. _cn_process_index:
 
+========================
 与Linux 内核社区一起工作
 ========================
 
-- 
2.30.2


-- 
Wu XiangCheng	0x32684A40BCA7AEA7

[PATCH 2/4] docs/zh_CN: add zh_CN/arch.rst

[Wu XiangCheng]

From: Wu XiangCheng <bobwxc@email.cn>

Add an entry for all zh arch documents.

Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
 Documentation/translations/zh_CN/arch.rst | 30 +++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/arch.rst

diff --git a/Documentation/translations/zh_CN/arch.rst b/Documentation/translations/zh_CN/arch.rst
new file mode 100644
index 000000000000..1603f076b14d
--- /dev/null
+++ b/Documentation/translations/zh_CN/arch.rst
@@ -0,0 +1,30 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+处理器体系结构
+==============
+
+以下文档提供了具体架构实现的编程细节。
+
+.. toctree::
+   :maxdepth: 2
+
+   mips/index
+   arm64/index
+   riscv/index
+   openrisc/index
+   parisc/index
+   loongarch/index
+
+TODOList:
+
+* arm/index
+* ia64/index
+* m68k/index
+* nios2/index
+* powerpc/index
+* s390/index
+* sh/index
+* sparc/index
+* x86/index
+* xtensa/index
+
-- 
2.30.2


-- 
Wu XiangCheng	0x32684A40BCA7AEA7

[PATCH 3/4] docs/zh_CN: Rewrite the Chinsese translation front page

[Wu XiangCheng]

From: Wu XiangCheng <bobwxc@email.cn>

update to commit 0c7b4366f1ab ("docs: Rewrite the front page")

Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
 Documentation/translations/zh_CN/index.rst | 169 +++++++--------------
 1 file changed, 51 insertions(+), 118 deletions(-)

diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index 2fc60e60feb4..7be728bed46d 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -26,165 +26,98 @@
 顺便说下，中文文档也需要遵守内核编码风格，风格中中文和英文的主要不同就是中文
 的字符标点占用两个英文字符宽度， 所以，当英文要求不要超过每行100个字符时，
 中文就不要超过50个字符。另外，也要注意'-'，'=' 等符号与相关标题的对齐。在将
-补丁提交到社区之前，一定要进行必要的checkpatch.pl检查和编译测试。
+补丁提交到社区之前，一定要进行必要的 ``checkpatch.pl`` 检查和编译测试。
 
-许可证文档
-----------
-
-下面的文档介绍了Linux内核源代码的许可证（GPLv2）、如何在源代码树中正确标记
-单个文件的许可证、以及指向完整许可证文本的链接。
+与Linux 内核社区一起工作
+------------------------
 
-* Documentation/translations/zh_CN/process/license-rules.rst
-
-用户文档
---------
-
-下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的
-用户。
+与内核开发社区进行协作并将工作推向上游的基本指南。
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   admin-guide/index
-
-TODOList:
-
-* kbuild/index
+   process/development-process
+   process/submitting-patches
+   行为准则 <process/code-of-conduct>
+   maintainer/index
+   完整开发流程文档 <process/index>
 
-固件相关文档
-------------
+内部API文档
+-----------
 
-下列文档描述了内核需要的平台固件相关信息。
+开发人员使用的内核内部交互接口手册。
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   devicetree/index
+   core-api/index
+   driver-api/index
+   内核中的锁 <locking/index>
 
 TODOList:
 
-* firmware-guide/index
-
-应用程序开发人员文档
---------------------
-
-用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。
-
-TODOlist:
-
-* userspace-api/index
+* subsystem-apis
 
-内核开发简介
-------------
+开发工具和流程
+--------------
 
-这些手册包含有关如何开发内核的整体信息。内核社区非常庞大，一年下来有数千名
-开发人员做出贡献。与任何大型社区一样，知道如何完成任务将使得更改合并的过程
-变得更加容易。
+为所有内核开发人员提供有用信息的各种其他手册。
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   process/index
-   dev-tools/index
+   process/license-rules
    doc-guide/index
+   dev-tools/index
+   dev-tools/testing-overview
    kernel-hacking/index
-   maintainer/index
 
 TODOList:
 
 * trace/index
 * fault-injection/index
 * livepatch/index
-* rust/index
 
-内核API文档
------------
+面向用户的文档
+--------------
 
-以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的
-大部分信息都是直接从内核源代码获取的，并根据需要添加补充材料（或者至少是在
-我们设法添加的时候——可能不是所有的都是有需要的）。
+下列手册针对
+希望内核在给定系统上以最佳方式工作的*用户*，
+和查找内核用户空间API信息的程序开发人员。
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   core-api/index
-   driver-api/index
-   locking/index
-   accounting/index
-   cpu-freq/index
-   iio/index
-   infiniband/index
-   power/index
-   virt/index
-   sound/index
-   filesystems/index
-   scheduler/index
-   mm/index
-   peci/index
-   PCI/index
+   admin-guide/index
+   admin-guide/reporting-issues.rst
 
 TODOList:
 
-* block/index
-* cdrom/index
-* ide/index
-* fb/index
-* fpga/index
-* hid/index
-* i2c/index
-* isdn/index
-* leds/index
-* netlabel/index
-* networking/index
-* pcmcia/index
-* target/index
-* timers/index
-* spi/index
-* w1/index
-* watchdog/index
-* input/index
-* hwmon/index
-* gpu/index
-* security/index
-* crypto/index
-* bpf/index
-* usb/index
-* scsi/index
-* misc-devices/index
-* mhi/index
-
-体系结构无关文档
-----------------
-
-TODOList:
+* 内核构建系统 <kbuild/index>
+* 用户空间工具 <tools/index>
+* userspace-api/index
 
-* asm-annotations
+固件相关文档
+------------
 
-特定体系结构文档
-----------------
+下列文档描述了内核需要的平台固件相关信息。
 
 .. toctree::
    :maxdepth: 2
 
-   mips/index
-   arm64/index
-   riscv/index
-   openrisc/index
-   parisc/index
-   loongarch/index
+   devicetree/index
 
 TODOList:
 
-* arm/index
-* ia64/index
-* m68k/index
-* nios2/index
-* powerpc/index
-* s390/index
-* sh/index
-* sparc/index
-* x86/index
-* xtensa/index
+* firmware-guide/index
+
+体系结构文档
+------------
+
+.. toctree::
+   :maxdepth: 2
+
+   arch
 
 其他文档
 --------
@@ -195,9 +128,9 @@ TODOList:
 TODOList:
 
 * staging/index
-* watch_queue
 
-目录和表格
+
+索引和表格
 ----------
 
 * :ref:`genindex`
-- 
2.30.2


-- 
Wu XiangCheng	0x32684A40BCA7AEA7

[PATCH 4/4] docs/zh_CN: add a man-pages link to zh_CN/index.rst

[Wu XiangCheng]

From: Wu XiangCheng <bobwxc@email.cn>

update to commit 489876063fb1 ("docs: add a man-pages link to the front
page")

Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
 Documentation/translations/zh_CN/index.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index 7be728bed46d..ec99ef5fe990 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -97,6 +97,8 @@ TODOList:
 * 用户空间工具 <tools/index>
 * userspace-api/index
 
+也可参考独立于内核文档的 `Linux 手册页 <https://www.kernel.org/doc/man-pages/>`_ 。
+
 固件相关文档
 ------------
 
-- 
2.30.2


-- 
Wu XiangCheng	0x32684A40BCA7AEA7

Re: [PATCH 0/4] docs/zh_CN: Rewrite the zh_CN/index.rst

[Yanteng Si]

On 10/5/22 13:13, Wu XiangCheng wrote:
> Follow Jonathan's steps[1], rewrite the entry point of kernel's Chinese
> translation documentation.
>
> Thanks,
>
> [1]: https://lore.kernel.org/linux-doc/20220927160559.97154-1-corbet@lwn.net/T
>
> Wu XiangCheng (4):
>    docs/zh_CN: promote the title of zh_CN/process/index.rst
>    docs/zh_CN: add zh_CN/arch.rst
>    docs/zh_CN: Rewrite the Chinsese translation front page
>    docs/zh_CN: add a man-pages link to zh_CN/index.rst

When I apply your patch set, Git says:


Applying: docs/zh_CN: promote the title of zh_CN/process/index.rst
Applying: docs/zh_CN: add zh_CN/arch.rst
.git/rebase-apply/patch:41: new blank line at EOF.
+
warning: 1 line adds whitespace errors.
Applying: docs/zh_CN: Rewrite the Chinsese translation front page
Applying: docs/zh_CN: add a man-pages link to zh_CN/index.rst


Thanks,

Yanteng

>
>   Documentation/translations/zh_CN/arch.rst     |  30 ++++
>   Documentation/translations/zh_CN/index.rst    | 169 ++++++------------
>   .../translations/zh_CN/process/index.rst      |   1 +
>   3 files changed, 83 insertions(+), 117 deletions(-)
>   create mode 100644 Documentation/translations/zh_CN/arch.rst
>
>
> base-commit: 05fff6ba04eef8b88bb94734b66731bef3d8d34b

Re: [PATCH 0/4] docs/zh_CN: Rewrite the zh_CN/index.rst

[Wu XiangCheng]

2022-10-08 (六) 12:11:06 +0800 Yanteng Si 曰：
> 
> On 10/5/22 13:13, Wu XiangCheng wrote:
> > Follow Jonathan's steps[1], rewrite the entry point of kernel's Chinese
> > translation documentation.
> > 
> > Thanks,
> > 
> > [1]: https://lore.kernel.org/linux-doc/20220927160559.97154-1-corbet@lwn.net/T
> > 
> > Wu XiangCheng (4):
> >    docs/zh_CN: promote the title of zh_CN/process/index.rst
> >    docs/zh_CN: add zh_CN/arch.rst
> >    docs/zh_CN: Rewrite the Chinsese translation front page
> >    docs/zh_CN: add a man-pages link to zh_CN/index.rst
> 
> When I apply your patch set, Git says:
> 
> 
> Applying: docs/zh_CN: promote the title of zh_CN/process/index.rst
> Applying: docs/zh_CN: add zh_CN/arch.rst
> .git/rebase-apply/patch:41: new blank line at EOF.
> +
> warning: 1 line adds whitespace errors.
> Applying: docs/zh_CN: Rewrite the Chinsese translation front page
> Applying: docs/zh_CN: add a man-pages link to zh_CN/index.rst
> 

OK. Will be fixed in v2.

Thanks,

-- 
Wu XiangCheng	0x32684A40BCA7AEA7