[PATCH] docs/zh_CN: add docs-next checkout workaround

From: Weijie Yuan

Date: Thu Jul 09 2026 - 11:33:41 EST


Hi all,

Since cloning Alex Shi's tree from the HUST mirror may be unstable, as
reported in [1]. I think adding one more option for beginners to get
started might be a good idea.

Thanks,
Weijie

[1] https://lore.kernel.org/linux-doc/4292BADB2022F3A5+5117009.JcJflTAXpt@anka-vmware20-1/

--- >8 ---

The Chinese documentation guide asks contributors to base their work on
the docs-next branch of Alex Shi's tree. However, cloning that tree from
git.kernel.org or mirrors.hust.edu.cn may fail in some network
environments.

Document an alternative workflow: clone Linus Torvalds' tree from a
local mirror, add Alex Shi's tree as another remote, fetch docs-next
from it, and then create a local branch that tracks alexs/docs-next.

Signed-off-by: Weijie Yuan <wy@xxxxxxxxx>
---
Documentation/translations/zh_CN/how-to.rst | 10 ++++++++++
1 file changed, 10 insertions(+)

diff --git a/Documentation/translations/zh_CN/how-to.rst b/Documentation/translations/zh_CN/how-to.rst
index 9ec2384e1e76..fcfe0a4a8be2 100644
--- a/Documentation/translations/zh_CN/how-to.rst
+++ b/Documentation/translations/zh_CN/how-to.rst
@@ -53,6 +53,16 @@ Linux 发行版和简单地使用 Linux 命令行,那么可以迅速开始了
这是 Alex 开发树的镜像库,每两个小时同步一次上游。如果您了解到更快的 mirror,
请随时 **添加** 。

+或者::
+
+ git clone https://mirrors.tuna.tsinghua.edu.cn/git/linux.git
+ cd linux
+ git remote add alexs https://git.kernel.org/pub/scm/linux/kernel/git/alexs/linux.git/
+ git fetch alexs docs-next:refs/remotes/alexs/docs-next
+ git switch -c docs-next --track alexs/docs-next
+
+这将先用清华源拉取 Linus Torvalds 的开发树,再增量下载中文开发分支中的内容。
+
命令执行完毕后,您会在当前目录下得到一个 linux 目录,该目录就是您之后的工作
仓库,请把它放在一个稳妥的位置。

--
2.55.0.795.g602f6c329a