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: <6fa7ad4d-1c92-121f-25c6-005fd5f1b6b9@amd.com>
Date:   Wed, 23 Nov 2022 10:27:19 -0600
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0)
 Gecko/20100101 Thunderbird/102.5.0
Subject: Re: [PATCH] docs/sp_SP: Add process coding-style translation
Content-Language: en-US
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org,
        bilbao@vt.edu
References: <20221115184737.712625-1-carlos.bilbao@amd.com>
 <87bkp09fkc.fsf@meer.lwn.net> <3ca31647-3f19-a9ca-c6b9-d6eba2014f2f@amd.com>
 <87edtt8wyl.fsf@meer.lwn.net>
From:   Carlos Bilbao <carlos.bilbao@amd.com>
In-Reply-To: <87edtt8wyl.fsf@meer.lwn.net>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?NmowcHdLcUpyM3REU0hIQXk0SWs5ZTQyMDUyWnNERmN5NUFPNW9DQ0l1eG1t?=
 =?utf-8?B?V1F6SWdlcFhZZ3h3NzhQcXZtOTNRQjU5ME1sQVJTRVRIZmxVR1EyWmpBWGhl?=
 =?utf-8?B?MDlSTUZEbWtSdFd3enZQYnYzNjk5dmRPQ3FHalo4aXJaZ2ZvNWNPQUFHRzF1?=
 =?utf-8?B?QnBmODhVUmJXNUNJVkU5Y2YreWlOOWxwNWVCTTQ4VzRsTU9IcEhVeFdMWU1P?=
 =?utf-8?B?M2U3U0RLcXBUSHFvbkZ5eWl0QmhoUGdyTTBIVGZ3MzdtV2ZKMEpmakIrVnpD?=
 =?utf-8?B?a0FqVHNPNENwa0FEMXNNN00zNldNek1teGViZ2o4UGpiYm5kbHM1bnVvUnIx?=
 =?utf-8?B?ZEJCVlU0eEl2L1FtdzdCcFV2Y2lMNFJKTXJxRDFNbnpnQjBySFVJcDJPcTU0?=
 =?utf-8?B?RGRXOUJ4VXpQNDNyaVprWW5ob2toWE1YdEdEZlNRQ2FVai84T3RUL3ZjajIw?=
 =?utf-8?B?cmJuV2FqelFiOHVsV2g2VGZ0MEVKVXJHYmJRak1ZVVYzVUxDVTlpTTRqdmJV?=
 =?utf-8?B?TngvbnZoVGwxWTR5OGN4SlRZQUlidVhMME5pV2FxL21ENkZESmZENkdSNXZT?=
 =?utf-8?B?M3BZN1hvVkY4VWhBc0VHejdqZkJpYzdpUTc2QnFzR3A1OGFlbEx5aitNY3BZ?=
 =?utf-8?B?V0wwSXhHVmtMdFMzaEhFUE5WNXZtbzAwRzFPMTAvUzJOYlNpZG1Na3JXQitR?=
 =?utf-8?B?THNONUNrVVhqb2hzYUp0WmNsQjdFSVd1UmorNHorbDFMTzBDdFh1NEtUNk4z?=
 =?utf-8?B?K1UvbXNjcVVQaVJYbkhWeTJONk5QbUZiWTdHOHJNNm1TOXcxOEkzbnpveTNV?=
 =?utf-8?B?dmpPMVZhZld0QnNDVGJFRm9Da0t2eVNtNGE4V0hLS3ZoRFUyVGdwVHNEcnk2?=
 =?utf-8?B?VGVDK0d3SUdTR28wZVpnWE9TcWdncVRLSzBWNzRsNmNSRnlub0JnYVVYWENt?=
 =?utf-8?B?amVqV3ZCNGRWc2ZIQnlYSklEYWJIcWVldzZzeDJ4R2c0Um5NNzQ0bTAzTUpK?=
 =?utf-8?B?Mm9ZWDFUeWtEcS9YczZ5WXJ2Wkx6b29adUxpR1IwY1h2NE1wenVJNEI5Rzlt?=
 =?utf-8?B?SGpOakhBTExIeUlqYmgzUjY5NFhpVHYvVnhObTFnQW9IWFRMRHNkL1BoNHNQ?=
 =?utf-8?B?a1VObnd4MWZCUU8zVXZzY3ZYNnhBV1VmaE51cjU3RkNYMDZua3g4OE9EcG5P?=
 =?utf-8?B?MDZEdFdpcVR3ekIzcVRCKzAzZGpZY3hONjhBL2EwRmg3QkcvdUVONGF4RGNU?=
 =?utf-8?B?YzF3czZNdWQ1QnR6UXZVb0NjRGtSYnNPV0NZak04MGRvb2s4NVhDVzhtelNT?=
 =?utf-8?B?S2wwd0JpLzd6SkdtTEN4bWJpK1dYZ1Zjc1RteWhkSE40YUhlVDBOcnp5UUMw?=
 =?utf-8?B?Rm5sVldVSFJSZS9zZDJIVDRvYTFIYzlraEIwdXJsdS8rOXd6cFRUTWdyZnl4?=
 =?utf-8?B?eFVwV3lnckQ2MmRtNHRRL3RnVExMMFBiL0tvQXdlVEs4SU43YWVLaFpNbTZR?=
 =?utf-8?B?Nm5iZnNkb0hKRUtRU1gydHlCY05sUW1YU1JMVGkrc3FYdVZLa1lBNWNFL2Ny?=
 =?utf-8?B?R2U0cnd4SmhkalNxUGJZSno1eEYzM3p3ZWpsYm00UjhMVHE2eGhqZkdtUkhG?=
 =?utf-8?B?TStXbzAyY0QxRDRqZUxhb3RVMjBzL0JPQjhJNjVlUnhLc2grTk8zRVBFaEx2?=
 =?utf-8?B?Y0xXYU9neGR6ZklLbEcramRNcE02RWY3ZE1Gc2s3bVV1Z3pteXo4WTRJR2dF?=
 =?utf-8?B?R3lqUGRNWE9CaGgzNjhJWkpiTGF2eUZuZ21iUmpkOW9ZQWs5ZGVLUEJoN3ht?=
 =?utf-8?B?M1RGeWM1SVdNdS8vbFpCOUQzN1ZaSHBSSXRJSExYNzBkN1RKNm1CTndrUEZP?=
 =?utf-8?B?TTJ5aWVkREFmMUZlcUcyTXpzNUxWS2pkeVZZVmwwWFFVKzZjOUpoczFVQjVV?=
 =?utf-8?B?d3VqUnhRNExHZkd1cklxOFNnUEE5Z2hocGMwQjJ3WUtRa0IweWRUTGYrOGN5?=
 =?utf-8?B?cUlyTTFpTllFVUtNTU9TSndhWmJHRTIxNXhJZEtISzFibW85RmlxWkIxdXR6?=
 =?utf-8?B?aW1jVDlwTG5qMStCQzlubE0xRVFDNUNjMjZtMC9Vakc3Smtjem9NeXlNVytM?=
 =?utf-8?B?TTdqZDYxYWZHd05ZTE9id2haZ1d5cjZmRXJhR1owY1lTbHY4SERyeGNmb3Zz?=
 =?utf-8?Q?hAdZEkW+Y3oopAlq/SYozpYvmV8TcChz0Op6U/aXRg7N?=
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 15ab4017-6669-4a51-1364-08dacd6f98d5
X-MS-Exchange-CrossTenant-AuthSource: BL1PR12MB5874.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Nov 2022 16:27:21.7229
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: Je03f1rrYUA1TXba0pHASU2sQqACS8QzYsEZ+otqzQTaOl1qn3+z/K5uyCrelsUSVRWQVgQ0sFIO5nrZzSRMig==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB6804
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS 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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On 11/23/22 10:19 AM, Jonathan Corbet wrote:
> Carlos Bilbao <carlos.bilbao@amd.com> writes:
> 
>> On 11/21/22 3:13 PM, Jonathan Corbet wrote:
>>> Carlos Bilbao <carlos.bilbao@amd.com> writes:
>>>
>>>> Translate Documentation/process/coding-style.rst into Spanish.
>>>>
>>>> Signed-off-by: Carlos Bilbao <carlos.bilbao@amd.com>
>>>> ---
>>>>  .../translations/sp_SP/coding-style.rst       | 1315 +++++++++++++++++
>>>>  Documentation/translations/sp_SP/index.rst    |    1 +
>>>>  2 files changed, 1316 insertions(+)
>>>>  create mode 100644 Documentation/translations/sp_SP/coding-style.rst
>>>
>>> So I'm kind of slow, I'll admit...but I have finally noticed that you're
>>> not preserving the directory structure used for Documentation/ as a
>>> whole.  Is there a reason for that?  We've been (slowly) working to
>>> organize our docs in a reader-friendly way, it seems unfortunate to lose
>>> that for the translations...?
>>
>> Yes, you're correct. The order I was following was: "If I didn't speak
>> English, what document would _I_ like to see translated next?". The coding
>> style directives seemed to me like the most important thing next in line. 
>> Following this logic, I was planning on translating
>> process/email-clients.rst next.
>>
>> What would be better? Perhaps the documents of process/ in order of
>> appearance? I don't know what would be preferable in terms of organization.
>> Perhaps we have some data on most consulted docs for the Documentation
>> website?
> 
> I think I didn't express myself clearly...I don't really care about the
> order in which you do the translations, whatever you think is best is
> fine there.  What I was asking about is the *directory structure* of the
> results.  Thus, for example, I think that this translation should end up
> in .../sp_SP/process/coding-style.rst.
> 
> See what I'm getting at?  The directory structure of the translations
> should really match that of the documents they are coming from.  Or, at
> least, so it seems to me.

Ah, that makes sense. I will send amended patches.

> 
> Thanks,
> 
> jon

Thanks,
Carlos