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: <8e2a1da1-2914-b223-85b0-a769339d9c39@gmail.com>
Date:   Tue, 18 Oct 2022 11:36:12 +0900
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.2.2
From:   Akira Yokosawa <akiyks@gmail.com>
Subject: Re: [PATCH v2 1/2] Documentation: Start translations to Spanish
To:     Matthew Wilcox <willy@infradead.org>
Cc:     Carlos Bilbao <carlos.bilbao@amd.com>, bilbao@vt.edu,
        corbet@lwn.net, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org, miguel.ojeda.sandonis@gmail.com,
        Akira Yokosawa <akiyks@gmail.com>
References: <20221014142454.871196-2-carlos.bilbao@amd.com>
 <48b4a5a1-2a52-4159-699b-9db73a012892@gmail.com>
 <Y01pkubcT7FOwCjL@casper.infradead.org>
Content-Language: en-US
In-Reply-To: <Y01pkubcT7FOwCjL@casper.infradead.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: bulk

On 2022/10/17 23:41, Matthew Wilcox wrote:
> On Sat, Oct 15, 2022 at 01:06:36PM +0900, Akira Yokosawa wrote:
>> Hi,
>> Minor nit on language code.
>>
>> On Fri, 14 Oct 2022 09:24:53 -0500, Carlos Bilbao wrote:
>>> Start the process of translating kernel documentation to Spanish. Create
>>> sp_SP/ and include an index and a disclaimer, following the approach of
>>> prior translations. Add Carlos Bilbao as MAINTAINER of this translation
>>> effort.
>> IIUC, the language code for "Spanish (Spain)" should be "es-ES", as is
>> listed at e.g., http://www.lingoes.net/en/translator/langcode.htm.
>>
>> The other translations use directory names found in the table, with
>> "-" replaced with "_".  It would be better to be consistent.
> 
> I don't know what standard we're actually following.  RFC5646 suggests
> simply using "es", with "es-419" for Latin America specialisation or
> "es-ES" for Spain.  I don't know how much variation there is between
> different Spanish dialects for technical documents; as I understand it,
> it's worth supporting two dialects of Chinese, but we merrily mix &
> match en_US and en_GB spellings.  Similarly, I wouldn't suggest that we
> have separate translations for fr_CA, fr_CH, fr_FR, just a single 'fr'
> would be fine.
> 
> We do need to be careful here; people are rightfully sensitive about
> being incorrectly grouped together.  If possible we should find a
> standard to follow that's been defined by experts in these matters.
> https://en.wikipedia.org/wiki/IETF_language_tag may be a good place to
> start looking.

I think generic "es" is OK, especially if "es_ES" can have such a
negative connotation to some. I just wanted to point out "sp_SP"
looks wrong.

Carlos, if you go the "es" way, it would be better to mention the
reason of the choice in the Changelog for future reference.

Subdirectories "ja_JP", "ko_KR", and "zh_CN" were added under
Documentation/ way back in 2007 (v2.6.23).

As you might see, two of the three language codes needed region
distinction and they were reasonable choices at the time.

        Thanks, Akira