Translation How-To renewal

[Raghavendra Kamath]

Hi Yuri,

Thank you for initiating this thread. 
The example posts by rabbiticTranslator blog are awesome. 
We can borrow some of the steps and descriptions if that is permitted.

I would suggest keeping the outline of the document simple and focusing 
on getting the newcomer started easily. We can always link to advanced 
tutorials at the end of simple tutorials.

For the basics here are some steps we could have - 

1. Introduction and welcome page.

2. How translations works in KDE. (getting the pot file and sending the 
po file to the team leader or contact ) I can help in creating a flow 
chart for this section.

3. Contacting the team and choosing the first applications for 
translation.

4. Getting the sources from svn (with brief introduction to svn)

5. Setting up Lokalize step by step. (with links to further reading for 
other programs) 

6. Checking the files for error and sending the files for review.

7. Some contact information about IRC and other chatroom for help in 
setting things up. 

I know these are most basic steps, I am merely suggesting these as a 
start for discussion. May be we can set up a common online editable 
document and write the contents of each page in it directly. 

I believe that giving a step by step or small guide using which the new 
contributor will at least get the source files and  have lokalize set up 
easily would be helpful. 

You can also ping me on IRC (raghukamath) or matrix 
(@raghukamath:kde.org) for more discussion.

Thank you. 

On Wednesday, 23 June, 2021 11:16:09 PM IST Yuri Chornoivan wrote:
> Hi,
> 
> As it was decided on our Akademy meeting our general translation
> manual [1] should be rewritten to take into account the following
> requirements
> 
> 1. The translation howto should be task-oriented
> 2. It should be concise.
> 3. It should address the following topics
>   “I want to start translating language foo”
>   “I’ve tried contacting language team foo but no answer”
>      when a team exist, when a team doesn’t exist (or doesn’t exist
> anymore) “I’ve got translation access, how do I move forward”
>     clear information on where translations can be found and the
> meaning of branches, and how to update and commit
>    Advanced information are fine, but should not hinder the
> comprehension of the the simple tasks
> 
> As you might know, the current manual code is here [2].
> 
> Please add your ideas and suggestions on the new content. Some points
> can be found in [3, 4].
> 
> Best regards,
> Yuri
> 
> [1] https://l10n.kde.org/docs/translation-howto/
> [2]
> https://websvn.kde.org/trunk/www/areas/l10n/docs/translation-howto/
> [3] https://rabbitictranslator.com/wordpress/index.php/2020/01/19/
> contributing-to-kde-localization/
> [4] https://rabbitictranslator.com/wordpress/index.php/2020/02/24/
> contributing-to-kde-simple-localization/


-- 
Raghavendra Kamath
emblik.studio