Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <479156cf-1bdb-421a-8dab-0db8ff73012b@loongson.cn>
Date:   Mon, 14 Aug 2023 15:58:10 +0800
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH RESEND v1] docs/zh_CN: add zh_CN translation for
 memory-barriers.txt
Content-Language: en-US
To:     Gang Li <gang.li@linux.dev>
Cc:     Jonathan Corbet <corbet@lwn.net>, Alex Shi <alexs@kernel.org>,
        Akira Yokosawa <akiyks@gmail.com>,
        Peter Zijlstra <peterz@infradead.org>,
        linux-doc@vger.kernel.org, linux-arch@vger.kernel.org,
        linux-mm@kvack.org, linux-kernel@vger.kernel.org,
        Alan Stern <stern@rowland.harvard.edu>,
        Andrea Parri <parri.andrea@gmail.com>,
        Will Deacon <will@kernel.org>,
        Boqun Feng <boqun.feng@gmail.com>,
        Nicholas Piggin <npiggin@gmail.com>,
        David Howells <dhowells@redhat.com>,
        Jade Alglave <j.alglave@ucl.ac.uk>,
        Luc Maranget <luc.maranget@inria.fr>,
        "Paul E. McKenney" <paulmck@kernel.org>,
        Daniel Lustig <dlustig@nvidia.com>,
        Joel Fernandes <joel@joelfernandes.org>,
        Andrew Morton <akpm@linux-foundation.org>
References: <20230811080851.84497-1-gang.li@linux.dev>
 <2f519a69-8f12-4c07-bf20-6776a5ada256@loongson.cn>
 <f8de40bf-1743-793f-7723-232adbfab623@linux.dev>
From:   Yanteng Si <siyanteng@loongson.cn>
In-Reply-To: <f8de40bf-1743-793f-7723-232adbfab623@linux.dev>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Precedence: bulk


在 2023/8/14 10:40, Gang Li 写道:
> Hi,
>
> On 2023/8/12 19:00, Yanteng Si wrote:
>> 在 2023/8/11 16:08, Gang Li 写道:
>>> +译注：
>>> +本文仅为方便汉语阅读，不保证与英文版本同步;
>>> +若有疑问，请阅读英文版本;
>>> +若有翻译问题，请通知译者；
>>> +若想修改文档，也请先修改英文版本。
>>
>> In fact, we already have an easier way to do this, just include 
>> disclaimer-zh_CN.
>>
>> If you observe the files under .../zh_CN/, they all have a similar 
>> header, and we can completely follow them.
>>
> Thanks. I just noticed that there are txt files under 
> "zh_CN/arch/arm64/" and "zh_CN/video4linux/". They have the same 
> header, and I will
> refer to them in v2.
>
>> But you should also have noticed that memory-barriers are not a 
>> standard rst file and will not be built, which will result in it only 
>> staying in the development tree.
>> It won't appear at:
> https://docs.kernel.org
> https://www.kernel.org/doc/html/latest/
>
> But people can still access the txt document in this way:
> https://www.kernel.org/doc/Documentation/memory-barriers.txt
>
>> Finally, this patch is too huge and we may need some time to review it.
>>
> Of course. Would it be more convenient if I split the file into multiple
> patches and send them as one series?
You didn't have to.


If you want to send a series, you can refactor the original document 
into rst format and make it the first patch of the series.

Just like:

[PATCH  v2 0/2] docs: Refactor memory-barriers.txt and translate it into 
Chinese

[PATCH  v2 1/2] docs: convert memory-barriers.txt to RST

[PATCH  v2 2/2] docs/zh_CN: add zh_CN translation for memory-barriers.rst


Thanks,

Yanteng

>
>>
>> Thanks,
>>
>> Yanteng
>>
>
> Thanks,
> Gang Li