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

[Dongliang Mu]

On 7/10/26 9:36 PM, Weijie Yuan wrote:
> 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.
Understood.
> > > 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
> 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. ;-)

I can help contact TUNA maintainers.

Dongliang Mu

> Thanks,
> Weijie