Received: by 2002:a6b:500f:0:0:0:0:0 with SMTP id e15csp2552801iob; Mon, 16 May 2022 00:10:03 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwJ8MGsYpwOeAOBVWncOCZbB6qHx/5ydK0sbTUhSX+UU/hAhyLJA1F0xz4jh4uwyJuK9hXo X-Received: by 2002:a05:6402:268f:b0:427:d90e:86a1 with SMTP id w15-20020a056402268f00b00427d90e86a1mr11414533edd.143.1652685003698; Mon, 16 May 2022 00:10:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1652685003; cv=none; d=google.com; s=arc-20160816; b=soZg+Q4ZGQLi2pYJVUoDAzoXMbEAnrV4r2g/nLB+Q1NfncqSy6DD2NxYDmbDnZccEY c/Y239uzKmBpK0OzgOL9yGb7qUbgGDnRtrP38oobrGqrNbpkHHQol6BODHYZqxz/RuD+ J5ubuEeSbtaxnJrw3coKG0TqL3oy1uo76SWMh32RixW6Q5jrx5hli+INAhgn2uuGS0q5 AcfQnTOCqmh1pq9iWkHgp4Qec8J1cknkaf4Ud5+CiFsvDsCvGKgBME4Nh81wPR5Kbug4 x2OhG4RoyLpf+qPZVAviXcF924Dm7OuaNY63Sfk6mwlIOlwXreyrQG6A+GS2NtoXzLGU yy2g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=SKEEjlHOSjFCa7bZJB6iPc+e+tHsD1OSOzTQKj2FpAM=; b=M8SnehWMye4eezte5TJP7agZYqKt+mP6zWmNcp0aLkHoX6XZcJl/fnHT9nuti8C7+U Sv6LxuDW7jgx7o/A8VBZrMOjpDCWsahqD5K9x5EZBwuG4Z78XLYU+aauUQQ7TSmXb5uY JxfBl68vL6Wy7rWlPcGjbBiV/5teSHeu9ZvHxkSh9hNlUl6qaEcji8/TCTPpKB9AmIAi tG3eWQfzdug7soRTruJyn4c6mhoV4VEdhYu0yIXRgtZa+9oSXxegsRvK+Z8QeL/IMy/X zqcA68/tIEmZM/9YvcTy4q1m1yNt4bfwpwCjdyW4XfTf99emMvZ/JGGTDhMospu4etdW kS+g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass (test mode) header.i=@email.cn header.s=dkim header.b=Xo4Zpwgo; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id cs9-20020a170906dc8900b006e88b062ff8si10033854ejc.679.2022.05.16.00.09.36; Mon, 16 May 2022 00:10:03 -0700 (PDT) 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; Authentication-Results: mx.google.com; dkim=pass (test mode) header.i=@email.cn header.s=dkim header.b=Xo4Zpwgo; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S237031AbiEOOPO (ORCPT + 99 others); Sun, 15 May 2022 10:15:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41984 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232613AbiEOOPM (ORCPT ); Sun, 15 May 2022 10:15:12 -0400 Received: from email.cn (m218-171.88.com [110.43.218.171]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9625127172; Sun, 15 May 2022 07:15:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=email.cn; s=dkim; h=Date:From:To; bh=SKEEjlHOSjFCa7bZJB6iPc+e+tHsD1OSOzTQK j2FpAM=; b=Xo4ZpwgolloRc5ZycBxBRATmBtQjJEH/o06WM9HvrRpUmliPLi+A5 wb8XPVQ7Amgr7LpzB1JKoXMu0dkX5X80jgbif8zv2bEVkaEtE7+vqrNQQMsuxymC AiMKm2m9CflRkfEMFN7o7nMu6Kv2fNliJSA49XRI+mpTXBSb19WDyw= Received: from bobwxc.top (unknown [120.242.68.220]) by v_coremail2-frontend-1 (Coremail) with SMTP id LCKnCgB33b3lCoFiZpaCAA--.64977S2; Sun, 15 May 2022 22:15:03 +0800 (CST) Date: Sun, 15 May 2022 22:14:59 +0800 From: "Wu X.C." To: Huacai Chen Cc: WANG Xuerui , Huacai Chen , Jonathan Corbet , linux-doc , LKML , Yanteng Si , Guo Ren , Alex Shi Subject: Re: [PATCH V10 02/22] Documentation/zh_CN: Add basic LoongArch documentations Message-ID: References: <20220514080402.2650181-1-chenhuacai@loongson.cn> <20220514080402.2650181-3-chenhuacai@loongson.cn> <7dc1abfd-e811-85b8-2a5b-8ace6ccb1ec7@xen0n.name> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: X-CM-TRANSID: LCKnCgB33b3lCoFiZpaCAA--.64977S2 X-Coremail-Antispam: 1UD129KBjvJXoWxCr1UWr1UKw4xXw4DAFyftFb_yoWrAF4fpa 40gFyfGan7Jw13Cws2gw1UJF15JF1xCw47GF1aqw109rnIyrs5KrWDtryqgF97Jry0vFWj qF4rKryY9F15A3DanT9S1TB71UUUUUUqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUgIb7Iv0xC_Kw4lb4IE77IF4wAFc2x0x2IEx4CE42xK8VAvwI8I cIk0rVWrJVCq3wA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK021l84ACjcxK6xIIjx v20xvE14v26r1I6r4UM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4j6F4UM28EF7xvwVC2 z280aVAFwI0_GcCE3s1l84ACjcxK6I8E87Iv6xkF7I0E14v26F4UJVW0owAS0I0E0xvYzx vE52x082IY62kv0487Mc02F40EFcxC0VAKzVAqx4xG6I80ewAv7VCjz48v1sIEY20_Cr1U Jr1lOx8S6xCaFVCjc4AY6r1j6r4UM4x0Y48IcVAKI48JMxkIecxEwVAFwVW5XwCF04k20x vY0x0EwIxGrwCF04k20xvE74AGY7Cv6cx26F4UJr1UMxC20s026xCaFVCjc4AY6r1j6r4U MI8I3I0E5I8CrVAFwI0_Jr0_Jr4lx2IqxVCjr7xvwVAFwI0_JrI_JrWlx4CE17CEb7AF67 AKxVWUtVW8ZwCIc40Y0x0EwIxGrwCI42IY6xIIjxv20xvE14v26r1j6r1xMIIF0xvE2Ix0 cI8IcVCY1x0267AKxVW8JVWxJwCI42IY6xAIw20EY4v20xvaj40_Jr0_JF4lIxAIcVC2z2 80aVAFwI0_Gr0_Cr1lIxAIcVC2z280aVCY1x0267AKxVW8Jr0_Cr1UYxBIdaVFxhVjvjDU 0xZFpf9x07jlxRDUUUUU= X-Originating-IP: [120.242.68.220] X-CM-SenderInfo: pere453f6hztlloou0/ X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi, On Sat, May 14, 2022 at 10:49:19PM +0800, Huacai Chen wrote: > Hi, Xuerui. > > On Sat, May 14, 2022 at 9:26 PM WANG Xuerui wrote: > > > > Hi, > > > > On 5/14/22 16:03, Huacai Chen wrote: > > > Add some basic documentation (zh_CN version) for LoongArch. LoongArch is > > > a new RISC ISA, which is a bit like MIPS or RISC-V. LoongArch includes a > > > reduced 32-bit version (LA32R), a standard 32-bit version (LA32S) and a > > > 64-bit version (LA64). > > > > > > Reviewed-by: Alex Shi > > > Reviewed-by: Yanteng Si > > > Signed-off-by: Huacai Chen > > > --- > > > Documentation/translations/zh_CN/index.rst | 1 + > > > .../translations/zh_CN/loongarch/features.rst | 8 + > > > .../translations/zh_CN/loongarch/index.rst | 26 ++ > > > .../zh_CN/loongarch/introduction.rst | 326 ++++++++++++++++++ > > > .../zh_CN/loongarch/irq-chip-model.rst | 167 +++++++++ > > > 5 files changed, 528 insertions(+) > > > create mode 100644 Documentation/translations/zh_CN/loongarch/features.rst > > > create mode 100644 Documentation/translations/zh_CN/loongarch/index.rst > > > create mode 100644 Documentation/translations/zh_CN/loongarch/introduction.rst > > > create mode 100644 Documentation/translations/zh_CN/loongarch/irq-chip-model.rst > > > > > > diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst > > > index 88d8df957a78..41c59950523c 100644 > > > --- a/Documentation/translations/zh_CN/index.rst > > > +++ b/Documentation/translations/zh_CN/index.rst > > > @@ -171,6 +171,7 @@ TODOList: > > > riscv/index > > > openrisc/index > > > parisc/index > > > + loongarch/index > > > > > > TODOList: > > > > > > diff --git a/Documentation/translations/zh_CN/loongarch/features.rst b/Documentation/translations/zh_CN/loongarch/features.rst > > > new file mode 100644 > > > index 000000000000..3886e635ec06 > > > --- /dev/null > > > +++ b/Documentation/translations/zh_CN/loongarch/features.rst > > > @@ -0,0 +1,8 @@ > > > +.. SPDX-License-Identifier: GPL-2.0 > > > + > > > +.. include:: ../disclaimer-zh_CN.rst > > > + > > > +:Original: Documentation/loongarch/features.rst > > > +:Translator: Huacai Chen > > > > Actually, here's an interesting situation: > > > > Every LoongArch (or Loongson) developer is native speaker of Chinese, > > not English, so most likely the "original" version of the various > > LoongArch documentation is actually the *Chinese* one, i.e. those added > > in this commit. As one can see, the English version has many unnatural > > expression recognizable even by a Chinese speaker (such as myself). I've > > seen worse translations (not necessarily in this patch series), broken > > to the point that even Chinese speakers with an adequate understanding > > of English (again, such as myself) *cannot* mentally map back into > > Chinese. (Usually such broken English are in fact perfect Chinese > > expression if mapped back word-for-word). > > > > So, how do we handle situation like this for the kernel documentation? > > Do we keep the English version as the "original" or "authoritative" > > version, even though they may be inaccurate compared to the > > "translation", or do we just switch a bit and move this "original" and > > "translator" information to the English version instead? > I think the Chinese version is the original one, and the English > version is translation. As Documentation/translations/index.rst said: but please bear in mind that the *only* official documentation is the English one So, whatever the original language is, you need to keep the correct of English version. Even the English version is a translation, it is still the official documentation. It seems impossible to mark a official version as "translation". But we can remove the translation tag in Chinese version and add a note to explain why. Also, that means Loongson need to keep the synchronization of documentation. Updating the "official" document when the "original" document is updated ;) Thanks, Wu > [...]