Re: [PATCH v2 3/3] docs: sp_SP: Add Spanish translation for Rust coding guidelines

[Carlos Bilbao <carlos.bilbao.osdev@gmail.com>]

Hello Miguel,

On 3/8/26 12:16, Miguel Ojeda wrote:
> On Sun, Mar 8, 2026 at 7:40 PM Carlos Bilbao
> <carlos.bilbao.osdev@gmail.com> wrote:
>> In Rust, there's some keywords like # Examples, # Safety, # Panics, etc,
>> that need to stay in English.
> I don't know what the translations' policy is, but shouldn't all code
> remain in English? i.e. not just section names, but comments and Rust
> docs (i.e. `///`, `//!` and `//`).
>
>  From a quick look, at least I see another couple translations that
> keeps them in English.


TBH, a reasonable case can be made either way, and there are no written
rules on this question AFAIK.

In terms of precedent, the Chinese (simplified) translation keeps code
blocks unchanged, which I suppose avoids giving the impression that
non-English comments are acceptable in kernel code.

That said, the goal of translation docs is accessibility, and since these
are illustrative snippets, Spanish comments help readers follow the example
without having to switch back to English. Personally, that argument
convinces me more.

>
> Thanks!
>
> Cheers,
> Miguel


Thanks,

Carlos