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

[Weijie Yuan <wy@wyuan.org>]

On Fri, Jul 10, 2026 at 09:21:16PM +0800, Dongliang Mu wrote:
> 
> On 7/9/26 11:25 PM, Weijie Yuan wrote:
> > 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 ---
> Is this a special mark for LKML? If I understand correctly, the following
> should be the patch content.

Yes, the following is the commit message body.

You can apply this patch by "git am -c" or "git am --scissors", which
means: Remove everything in body before a scissors line (see git-mailinfo[1]).

https://git-scm.com/docs/git-am#Documentation/git-am.txt---scissors

Git community sometimes use it, for the cases if you want to swap the
actual commit message and the supplementary information.

> > 
> > 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@wyuan.org>
> > ---
> >   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

Makes sense. Could I kindly ask, for example, Tsinghua tuna team to
mirror our repo, on behalf of our Chinese document team? I'm afraid they
are unlikely to consider my request in my individual capacity. ;-)

Thanks,
Weijie