Re: [PATCH] docs/zh_CN: add docs-next checkout workaround
From: Dongliang Mu
Date: Fri Jul 10 2026 - 09:24:39 EST
On 7/9/26 11:25 PM, Weijie Yuan wrote:
Hi all,Is this a special mark for LKML? If I understand correctly, the following should be the patch content.
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 的开发树，再增量下载中文开发分支中的内容。
This would make the envionment preparation more difficult. My suggestion is to ask maintainers of some mirror sites to sync this repo like us.
Dongliang Mu
+
命令执行完毕后，您会在当前目录下得到一个 linux 目录，该目录就是您之后的工作
仓库，请把它放在一个稳妥的位置。