Re: Translation of kernel documentation

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

On 6/10/24 13:44, Carlos Bilbao wrote:

> Hello Matic,
>
> On 6/7/24 14:11, Matthew Wilcox wrote:
>> On Fri, Jun 07, 2024 at 05:45:10PM +0000, Matic Urbanija wrote:
>>> Hi, 
>>>
>>> first of all, I'm terribly sorry if this isn't the right place to ask about translation. I sent an email to helpdesk but so far no answer from them.
>> This is the right place!
>>
>>> My name is Matic Urbanija, I am a teacher at Vegova - Upper Secondary School of Electrical and Computer Engineering and Technical Gymnasium Ljubljana, Slovenia (https://www.vegova.si/about-us-vegova/). 
>>>
>>> I would like to translate kernel documentation into Slovenian language. Maybe some of my students would also like to participate.
>>>
>>> Are there some special requirements or procedures which have to be fulfilled before starting translation project? What is the proper or recommend way to start to translate the kernel documentation?
>> Start by creating Documentation/translations/sl/ (the iso639 code for Slovenian)
>> Add an entry to Documentation/translations/index.rst
>> Add Documentation/translations/sl/index.rst
>
> Your first commit will probably resemble this:
> https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?h=next-20240607&id=444064185df7c4b0f7bb41e25b1bb197a1e4a918
> but, please, don't add yourself to MAINTAINERS if you aren't willing to review
> future contributions (maintaining).
> This is a fantastic way to introduce your students to the kernel
> contribution process. Note they should at least have a basic understanding
> of operating systems and low-level languages (mostly C) to translate
> effectively.
> Feel free to add my email in CC in future communications so I can help.
>

By the way, next time you probably want to CC linux-kernel@vger.kernel.org
so we can easily search for this thread (e.g., in lkml.org).


>> Now start adding documents ;-)
>>
>> You can send patches to this mailing list for Jon to apply to the
>> documentation tree for merging.
>>
> Thanks,
> Carlos


Thanks,
Carlos

>