linux-kernel - Re: [PATCH v2 1/1] MAINTAINERS: Become the docs/zh

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CAEensMzjCR+LWXw-xS95xMOea20yxUJ8c-f7EmYgP7EkpUePaw@mail.gmail.com>
Date:   Wed, 18 May 2022 22:05:29 +0800
From:   yanteng si <siyanteng01@...il.com>
To:     Jonathan Corbet <corbet@....net>
Cc:     Yanteng Si <siyanteng@...ngson.cn>, Alex Shi <alexs@...nel.org>,
        Alex Shi <seakeel@...il.com>, Wu XiangCheng <bobwxc@...il.cn>,
        Yeechou Tang <tangyeechou@...il.com>,
        Huacai Chen <chenhuacai@...nel.org>,
        Jiaxun Yang <jiaxun.yang@...goat.com>,
        Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        linux-kernel@...r.kernel.org
Subject: Re: [PATCH v2 1/1] MAINTAINERS: Become the docs/zh_CN maintainer

Jonathan Corbet <corbet@....net> 于2022年5月18日周三 03:28写道：
>
> Yanteng Si <siyanteng@...ngson.cn> writes:
>
> > It's time to become a maintainer of Chinese documentation, and Yanteng's plan
> > is to help everyone with the utmost enthusiasm and patience.
> >
> > Signed-off-by: Yanteng Si <siyanteng@...ngson.cn>
> > Reviewed-by: Alex Shi <alexs@...nel.org>
> > ---
> >  MAINTAINERS | 1 +
> >  1 file changed, 1 insertion(+)
> >
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index 9ce78f2275dc..ff1364d9f7cc 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -4649,6 +4649,7 @@ F:      Documentation/dev-tools/checkpatch.rst
> >
> >  CHINESE DOCUMENTATION
> >  M:   Alex Shi <alexs@...nel.org>
> > +M:   Yanteng Si <siyanteng@...ngson.cn>
> >  S:   Maintained
> >  F:   Documentation/translations/zh_CN/
>
> I've applied this.  I am curious, though: what is your sense for what
> being designated a "maintainer" means?  Do you envision something beyond
> reviewing patches (for which an "R:" entry would be most appropriate)?
>
> In any case, you help with the documentation is appreciated!

Jonathan Corbet, Alex Shi, and guys in the mail list.

We, all kernel developers who love Chinese documentation, are now
involved in a very interesting project: the localization of kernel
documentation into Chinese.

For a long time, we have been working on translating as much of the
English documentation into Chinese as possible, while neglecting to
maintain the growing amount of Chinese documentation, which is
becoming progressively more difficult to maintain. It's not just the
quantity that is difficult, but also the time. For example, if a
document is not updated in a timely manner, developers who have
difficulty with English will get old or even wrong guidelines, which
is not only a waste of time and effort for developers, but may also
result in the kernel not getting the code contributed by developers in
a timely manner.

During the translation, we found ourselves disagree on the translation
of some terms from time to time, especially on terms being translated
into Chinese for the first time; and sometimes it might not be easy to
reach agreement on such circumstances and provide a translation that
is trustworthy, up-to-date, and elegant in a short time.

At the same time, I've noticed that the translating kernel
documentations is a great entry point to  many newbies, which is a
good thing, but adds to the burden of reviewing Chinese documentation
patches, as most of them tend to have great enthusiasm but are
unfamiliar with the patch creation and submission process. Of course,
we have very detailed documentation guidelines and they are translated
into Chinese, but they still need some help from us in their practice
process.

But that is the past. And now we are looking only to the future.

I will do my best to keep all the Chinese documentation as up-to-date
as the English documentation, and I will keep an eye on the latest
changes to each original document and quickly sync them to the Chinese
documentation. At the same time, I will work to move forward with a
plan to produce a glossary of terms, and to revise the current
documentation where a single English word is translated into multiple
Chinese words. Finally, I will provide every developer with as much
help as I can with my utmost enthusiasm and patience.

Thanks,
Yanteng