* [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst
@ 2021-04-16 7:46 Wu XiangCheng
2021-04-16 14:24 ` teng sterling
2021-04-30 12:22 ` [PATCH v2] " Wu XiangCheng
0 siblings, 2 replies; 5+ messages in thread
From: Wu XiangCheng @ 2021-04-16 7:46 UTC (permalink / raw)
To: Alex Shi
Cc: Jonathan Corbet, Yanteng Si, Huang JiangHui, Bailu Lin, linux-doc
Adjust order and content of zh_CN/index.rst to make it clear,
Complete introductions and TODOLists.
Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
docs-next tree
base-commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++++++++++--
1 file changed, 159 insertions(+), 9 deletions(-)
diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index 2c154e18b37d..868efe11bb9d 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -1,34 +1,184 @@
+.. SPDX-License-Identifier: GPL-2.0
+
.. raw:: latex
\renewcommand\thesection*
\renewcommand\thesubsection*
+.. _linux_doc_zh:
+
中文翻译
========
-这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名开发
-人员做出贡献。 与任何大型社区一样,知道如何完成任务将使得更改合并的过程变得更
-加容易。
-翻译计划:
-内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
+.. note::
+
+ **翻译计划:**
+ 内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
+
+许可证文档
+----------
+
+下面的文档介绍了Linux内核源代码的许可证(GPLv2)、如何在源代码树中正确标记
+单个文件的许可证、以及指向完整许可证文本的链接。
+
+* Documentation/translations/zh_CN/process/license-rules.rst
+
+用户文档
+--------
+
+下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的
+用户。
.. toctree::
:maxdepth: 2
admin-guide/index
+
+TODOList:
+
+* kbuild/index
+
+固件相关文档
+------------
+
+下列文档描述了内核需要的平台固件相关信息。
+
+TODOList:
+
+* firmware-guide/index
+* devicetree/index
+
+应用程序开发人员文档
+--------------------
+
+用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。
+
+TODOlist:
+
+* userspace-api/index
+
+内核开发简介
+------------
+
+这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名
+开发人员做出贡献。与任何大型社区一样,知道如何完成任务将使得更改合并的过程
+变得更加容易。
+
+.. toctree::
+ :maxdepth: 2
+
process/index
dev-tools/index
doc-guide/index
kernel-hacking/index
- filesystems/index
- arm64/index
- sound/index
+
+TODOList:
+
+* trace/index
+* maintainer/index
+* fault-injection/index
+* livepatch/index
+* rust/index
+
+内核API文档
+-----------
+
+以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的
+大部分信息都是直接从内核源代码获取的,并根据需要添加补充材料(或者至少是在
+我们设法添加的时候——可能不是所有的都是有需要的)。
+
+.. toctree::
+ :maxdepth: 2
+
cpu-freq/index
- mips/index
iio/index
+ sound/index
+ filesystems/index
+
+TODOList:
+
+* driver-api/index
+* core-api/index
+* locking/index
+* accounting/index
+* block/index
+* cdrom/index
+* ide/index
+* fb/index
+* fpga/index
+* hid/index
+* i2c/index
+* isdn/index
+* infiniband/index
+* leds/index
+* netlabel/index
+* networking/index
+* pcmcia/index
+* power/index
+* target/index
+* timers/index
+* spi/index
+* w1/index
+* watchdog/index
+* virt/index
+* input/index
+* hwmon/index
+* gpu/index
+* security/index
+* crypto/index
+* vm/index
+* bpf/index
+* usb/index
+* PCI/index
+* scsi/index
+* misc-devices/index
+* scheduler/index
+* mhi/index
+
+体系结构无关文档
+----------------
+
+TODOList:
+
+* asm-annotations
+
+特定体系结构文档
+----------------
+
+.. toctree::
+ :maxdepth: 2
+
+ mips/index
+ arm64/index
riscv/index
+TODOList:
+
+* arm/index
+* ia64/index
+* m68k/index
+* nios2/index
+* openrisc/index
+* parisc/index
+* powerpc/index
+* s390/index
+* sh/index
+* sparc/index
+* x86/index
+* xtensa/index
+
+其他文档
+--------
+
+有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或
+转换为reStructureText格式,也有可能太旧。
+
+TODOList:
+
+* staging/index
+* watch_queue
+
目录和表格
----------
--
2.11.0
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst
2021-04-16 7:46 [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst Wu XiangCheng
@ 2021-04-16 14:24 ` teng sterling
2021-04-16 14:38 ` Wu X.C.
2021-04-30 12:22 ` [PATCH v2] " Wu XiangCheng
1 sibling, 1 reply; 5+ messages in thread
From: teng sterling @ 2021-04-16 14:24 UTC (permalink / raw)
To: Wu XiangCheng
Cc: Alex Shi, Jonathan Corbet, Yanteng Si, Huang JiangHui, Bailu Lin,
linux-doc
Wu XiangCheng <bobwxc@email.cn> 于2021年4月16日周五 下午4:06写道:
>
> Adjust order and content of zh_CN/index.rst to make it clear,
> Complete introductions and TODOLists.
>
> Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
> ---
> docs-next tree
> base-commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
>
> Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++++++++++--
> 1 file changed, 159 insertions(+), 9 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> index 2c154e18b37d..868efe11bb9d 100644
> --- a/Documentation/translations/zh_CN/index.rst
> +++ b/Documentation/translations/zh_CN/index.rst
> @@ -1,34 +1,184 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> .. raw:: latex
>
> \renewcommand\thesection*
> \renewcommand\thesubsection*
>
> +.. _linux_doc_zh:
> +
> 中文翻译
> ========
>
> -这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名开发
> -人员做出贡献。 与任何大型社区一样,知道如何完成任务将使得更改合并的过程变得更
> -加容易。
>
> -翻译计划:
> -内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
> +.. note::
> +
> + **翻译计划:**
> + 内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
> +
> +许可证文档
> +----------
> +
> +下面的文档介绍了Linux内核源代码的许可证(GPLv2)、如何在源代码树中正确标记
> +单个文件的许可证、以及指向完整许可证文本的链接。
> +
> +* Documentation/translations/zh_CN/process/license-rules.rst
> +
> +用户文档
> +--------
> +
> +下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的
> +用户。
>
> .. toctree::
> :maxdepth: 2
>
> admin-guide/index
> +
> +TODOList:
> +
> +* kbuild/index
> +
> +固件相关文档
> +------------
> +
> +下列文档描述了内核需要的平台固件相关信息。
> +
> +TODOList:
> +
> +* firmware-guide/index
> +* devicetree/index
> +
> +应用程序开发人员文档
> +--------------------
> +
> +用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。
> +
> +TODOlist:
> +
> +* userspace-api/index
> +
> +内核开发简介
> +------------
> +
> +这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名
> +开发人员做出贡献。与任何大型社区一样,知道如何完成任务将使得更改合并的过程
> +变得更加容易。
> +
> +.. toctree::
> + :maxdepth: 2
> +
> process/index
> dev-tools/index
> doc-guide/index
> kernel-hacking/index
> - filesystems/index
> - arm64/index
> - sound/index
> +
> +TODOList:
> +
> +* trace/index
> +* maintainer/index
> +* fault-injection/index
> +* livepatch/index
> +* rust/index
> +
> +内核API文档
> +-----------
> +
> +以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的
> +大部分信息都是直接从内核源代码获取的,并根据需要添加补充材料(或者至少是在
> +我们设法添加的时候——可能不是所有的都是有需要的)。
> +
> +.. toctree::
> + :maxdepth: 2
> +
> cpu-freq/index
> - mips/index
> iio/index
> + sound/index
> + filesystems/index
> +
> +TODOList:
> +
> +* driver-api/index
> +* core-api/index
> +* locking/index
> +* accounting/index
> +* block/index
> +* cdrom/index
> +* ide/index
> +* fb/index
> +* fpga/index
> +* hid/index
> +* i2c/index
> +* isdn/index
> +* infiniband/index
> +* leds/index
> +* netlabel/index
> +* networking/index
> +* pcmcia/index
> +* power/index
> +* target/index
> +* timers/index
> +* spi/index
> +* w1/index
> +* watchdog/index
> +* virt/index
> +* input/index
> +* hwmon/index
> +* gpu/index
> +* security/index
> +* crypto/index
> +* vm/index
> +* bpf/index
> +* usb/index
> +* PCI/index
> +* scsi/index
> +* misc-devices/index
> +* scheduler/index
> +* mhi/index
> +
> +体系结构无关文档
> +----------------
> +
> +TODOList:
> +
> +* asm-annotations
> +
> +特定体系结构文档
> +----------------
> +
> +.. toctree::
> + :maxdepth: 2
> +
> + mips/index
> + arm64/index
> riscv/index
>
> +TODOList:
> +
> +* arm/index
> +* ia64/index
> +* m68k/index
> +* nios2/index
> +* openrisc/index
> +* parisc/index
> +* powerpc/index
> +* s390/index
> +* sh/index
> +* sparc/index
> +* x86/index
> +* xtensa/index
> +
> +其他文档
> +--------
> +
> +有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或
和/或?
emmm…… can you remove one? Or split into two sentences?:)
> +转换为reStructureText格式,也有可能太旧。
> +
> +TODOList:
> +
> +* staging/index
> +* watch_queue
> +
> 目录和表格
> ----------
>
>
> --
> 2.11.0
>
Thanks,
Yanteng
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst
2021-04-16 14:24 ` teng sterling
@ 2021-04-16 14:38 ` Wu X.C.
0 siblings, 0 replies; 5+ messages in thread
From: Wu X.C. @ 2021-04-16 14:38 UTC (permalink / raw)
To: teng sterling
Cc: Alex Shi, Jonathan Corbet, Yanteng Si, Huang JiangHui, Bailu Lin,
linux-doc
On Fri, Apr 16, 2021 at 10:24:00PM +0800, teng sterling wrote:
> Wu XiangCheng <bobwxc@email.cn> 于2021年4月16日周五 下午4:06写道:
> >
> > Adjust order and content of zh_CN/index.rst to make it clear,
> > Complete introductions and TODOLists.
> >
> > Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
> > ---
> > docs-next tree
> > base-commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
> >
> > Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++++++++++--
> > 1 file changed, 159 insertions(+), 9 deletions(-)
> >
> > diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> > index 2c154e18b37d..868efe11bb9d 100644
[...]
> > +其他文档
> > +--------
> > +
> > +有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或
> 和/或?
> emmm…… can you remove one? Or split into two sentences?:)
or may require some adjustments and/or conversion to ReStructured Text format
^^^^^^
So as it, it's OK.
Thanks,
Wu X.C.
> > +转换为reStructureText格式,也有可能太旧。
> > +
> > +TODOList:
> > +
> > +* staging/index
> > +* watch_queue
> > +
> > 目录和表格
> > ----------
> >
> >
> > --
> > 2.11.0
> >
>
> Thanks,
>
> Yanteng
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH v2] docs/zh_CN: Adjust order and content of zh_CN/index.rst
2021-04-16 7:46 [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst Wu XiangCheng
2021-04-16 14:24 ` teng sterling
@ 2021-04-30 12:22 ` Wu XiangCheng
2021-05-03 22:51 ` Jonathan Corbet
1 sibling, 1 reply; 5+ messages in thread
From: Wu XiangCheng @ 2021-04-30 12:22 UTC (permalink / raw)
To: Alex Shi
Cc: Jonathan Corbet, Yanteng Si, Huang JiangHui, Bailu Lin, linux-doc
Adjust order and content of zh_CN/index.rst to make it clear,
complete introductions and TODOLists.
Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
---
base on jc/docs-next
v2:
rebase to newest docs-next
v1:
<https://lore.kernel.org/linux-doc/20210416074652.GA6138@bobwxc.top/>
Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++--
1 file changed, 158 insertions(+), 10 deletions(-)
diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index ee6b20ca9080..d56d6b7092e6 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -1,36 +1,184 @@
+.. SPDX-License-Identifier: GPL-2.0
+
.. raw:: latex
\renewcommand\thesection*
\renewcommand\thesubsection*
+.. _linux_doc_zh:
+
中文翻译
========
-这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名开发
-人员做出贡献。 与任何大型社区一样,知道如何完成任务将使得更改合并的过程变得更
-加容易。
-翻译计划:
-内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
+.. note::
+
+ **翻译计划:**
+ 内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
+
+许可证文档
+----------
+
+下面的文档介绍了Linux内核源代码的许可证(GPLv2)、如何在源代码树中正确标记
+单个文件的许可证、以及指向完整许可证文本的链接。
+
+* Documentation/translations/zh_CN/process/license-rules.rst
+
+用户文档
+--------
+
+下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的
+用户。
.. toctree::
:maxdepth: 2
admin-guide/index
+
+TODOList:
+
+* kbuild/index
+
+固件相关文档
+------------
+
+下列文档描述了内核需要的平台固件相关信息。
+
+TODOList:
+
+* firmware-guide/index
+* devicetree/index
+
+应用程序开发人员文档
+--------------------
+
+用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。
+
+TODOlist:
+
+* userspace-api/index
+
+内核开发简介
+------------
+
+这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名
+开发人员做出贡献。与任何大型社区一样,知道如何完成任务将使得更改合并的过程
+变得更加容易。
+
+.. toctree::
+ :maxdepth: 2
+
process/index
dev-tools/index
doc-guide/index
kernel-hacking/index
- filesystems/index
- arm64/index
- sound/index
+
+TODOList:
+
+* trace/index
+* maintainer/index
+* fault-injection/index
+* livepatch/index
+* rust/index
+
+内核API文档
+-----------
+
+以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的
+大部分信息都是直接从内核源代码获取的,并根据需要添加补充材料(或者至少是在
+我们设法添加的时候——可能不是所有的都是有需要的)。
+
+.. toctree::
+ :maxdepth: 2
+
+ core-api/index
cpu-freq/index
- mips/index
iio/index
+ sound/index
+ filesystems/index
+
+TODOList:
+
+* driver-api/index
+* locking/index
+* accounting/index
+* block/index
+* cdrom/index
+* ide/index
+* fb/index
+* fpga/index
+* hid/index
+* i2c/index
+* isdn/index
+* infiniband/index
+* leds/index
+* netlabel/index
+* networking/index
+* pcmcia/index
+* power/index
+* target/index
+* timers/index
+* spi/index
+* w1/index
+* watchdog/index
+* virt/index
+* input/index
+* hwmon/index
+* gpu/index
+* security/index
+* crypto/index
+* vm/index
+* bpf/index
+* usb/index
+* PCI/index
+* scsi/index
+* misc-devices/index
+* scheduler/index
+* mhi/index
+
+体系结构无关文档
+----------------
+
+TODOList:
+
+* asm-annotations
+
+特定体系结构文档
+----------------
+
+.. toctree::
+ :maxdepth: 2
+
+ mips/index
+ arm64/index
riscv/index
- core-api/index
openrisc/index
+TODOList:
+
+* arm/index
+* ia64/index
+* m68k/index
+* nios2/index
+* parisc/index
+* powerpc/index
+* s390/index
+* sh/index
+* sparc/index
+* x86/index
+* xtensa/index
+
+其他文档
+--------
+
+有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或
+转换为reStructureText格式,也有可能太旧。
+
+TODOList:
+
+* staging/index
+* watch_queue
+
目录和表格
----------
base-commit: 80342d484afceec491bcc85ff1e32c5491c1182f
--
2.20.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH v2] docs/zh_CN: Adjust order and content of zh_CN/index.rst
2021-04-30 12:22 ` [PATCH v2] " Wu XiangCheng
@ 2021-05-03 22:51 ` Jonathan Corbet
0 siblings, 0 replies; 5+ messages in thread
From: Jonathan Corbet @ 2021-05-03 22:51 UTC (permalink / raw)
To: Wu XiangCheng, Alex Shi; +Cc: Yanteng Si, Huang JiangHui, Bailu Lin, linux-doc
Wu XiangCheng <bobwxc@email.cn> writes:
> Adjust order and content of zh_CN/index.rst to make it clear,
> complete introductions and TODOLists.
>
> Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
> ---
> base on jc/docs-next
>
> v2:
> rebase to newest docs-next
>
> v1:
> <https://lore.kernel.org/linux-doc/20210416074652.GA6138@bobwxc.top/>
>
> Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++--
> 1 file changed, 158 insertions(+), 10 deletions(-)
Applied, thanks.
jon
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-05-03 22:51 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-16 7:46 [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst Wu XiangCheng
2021-04-16 14:24 ` teng sterling
2021-04-16 14:38 ` Wu X.C.
2021-04-30 12:22 ` [PATCH v2] " Wu XiangCheng
2021-05-03 22:51 ` Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).