Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8;
 format=flowed
Content-Transfer-Encoding: 8bit
Date:   Mon, 11 Mar 2019 22:02:01 +0100
From:   Federico Vaga <federico.vaga@vaga.pv.it>
To:     Alex Shi <alex.shi@linux.alibaba.com>
Cc:     linux-doc@vger.kernel.org, lkml <linux-kernel@vger.kernel.org>,
        Jonathan Corbet <corbet@lwn.net>, harryxiyou@gmail.com,
        Li Zefan <lizefan@huawei.com>,
        Shawn Guo <shawn.guo@linaro.org>,
        Fengguang Wu <fengguang.wu@intel.com>
Subject: Re: [RFC PATCH] doc: translation disclaimer
In-Reply-To: <8aad62be-e088-c5e1-e2df-a270c62ce1a1@linux.alibaba.com>
References: <20190305220611.13136-1-federico.vaga@vaga.pv.it>
 <02cb673f-eaf0-f78a-49f3-e95340748694@linux.alibaba.com>
 <1683884.6qb0gnyTyR@pcbe13614>
 <8aad62be-e088-c5e1-e2df-a270c62ce1a1@linux.alibaba.com>
Message-ID: <833e824cd99f7ed282dfe175ae59876d@vaga.pv.it>
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On 2019-03-07 05:03, Alex Shi wrote:
> On 2019/3/6 11:17 下午, Federico Vaga wrote:
> 
>> As I wrote in the commit message, this is just a  example to show
>> the
>> structure and share the main message.
>> 
>> What I wrote is just a 10 minutes sketch, to share an idea. This is
>> **not**
>> the text that I'm proposing; what I'm proposing here are the
>> structure and the
>> concepts/ideas/messages. The final patch will be written
>> appropriately, but
>> before doing it I would like to collect the messages that we want to
>> put in
>> it; I listed above what I think is necessary to say.
> 
> Got it. yes, it's a good idea, and we'd better figure out the more
> elegant, precise and legally words. :)

I wouldn't go that far with the legal jargon. There is nothing legal 
about
this, only that who read a translation must be aware of its limitations.


>> +
>> +Translations
>> +------------
>> +
>> 
>> .. toctree::
>> :maxdepth: 1
>> 
>> diff --git a/Documentation/translations/it_IT/disclaimer-ita.rst
>> b/Documentation/translations/it_IT/disclaimer-ita.rst index
>> d68e52de6a5d..aacc1a0346db 100644
>> --- a/Documentation/translations/it_IT/disclaimer-ita.rst
>> +++ b/Documentation/translations/it_IT/disclaimer-ita.rst
>> @@ -1,13 +1,6 @@
>> 
>> :orphan:
>> 
>> why the orphan here? does that mean no maintainer for it_IT
>> currently?
> 
> It is a Sphinx tag to avoid warnings at build time. Instead of
> re-writing
> exactly the same text in all files, this one is included at the top of
> all
> translated documents. But, since it is not a real document this is not
> 
> included in any TOC and sphinx complains; that's why we need the
> orphan tag
> 
> http://www.sphinx-doc.org/en/master/usage/restructuredtext/field-lists.html#metadata
> 
>  Thanks a lot for the explanations! :)

-- 
Federico Vaga
http://www.federicovaga.it/