search

google / comprehensive-rust

This is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.
https://google.github.io/comprehensive-rust/
Apache License 2.0
27.73k stars 1.66k forks source link

Russian translation #326

Open mgeisler opened 1 year ago

mgeisler commented 1 year ago

For reference, there is a Russian translation of the Rust Book: https://github.com/rust-lang-ru/book.

Say hello below and assign yourself one or more files via this spreadsheet.

mgeisler commented 1 year ago

Here is a Cloud Translated version of messages.pot: ru.zip. I hope it can work as a starting point for you :smile:

mgeisler commented 1 year ago

For reference, there is a Russian translation of the Rust Book: https://github.com/rust-lang-ru/book.

baltuky commented 1 year ago

@mgeisler Would appreciate if you could assign this issue to me

mgeisler commented 1 year ago

@mgeisler Would appreciate if you could assign this issue to me

There you go! :smile:

mgeisler commented 1 year ago

Hi @baltuky, would you be able to add a nearly-empty PO file for Russian? Just translate a few entries — that will get us started and it will make it easier for others to start contributing!

baltuky commented 1 year ago

Hey Martin, Yes, I've created a PO file for Russian. I will create a PR for that later today.

mgeisler commented 1 year ago

Yes, I've created a PO file for Russian. I will create a PR for that later today.

That's amazing, thank you very much!

baltuky commented 1 year ago

@mgeisler I've created a PR that brings a fresh ru.po file, PTAL

atmsk commented 1 year ago

I would like to contribute. How do I get started?

baltuky commented 1 year ago

I would like to contribute. How do I get started?

Hey 👋 It makes sense to start by reading the Translations of Comprehensive Rust 🦀 page.

I've prepared a draft of Day 1: Morning part and working on Day 1: Afternoon. So, feel free to pick any other chapters.

istolga commented 1 year ago

also want to contribute

mgeisler commented 1 year ago

Hey all! There seems to be great momentum here! I propose that you split the work via a spreadsheet. That seems to work well for the two Chinese translations.

Edit it all you want, use as much or as little as you like!

baltuky commented 1 year ago

Hey all! There seems to be great momentum here! I propose that you split the work via a spreadsheet. That seems to work well for the two Chinese translations.

Edit it all you want, use as much or as little as you like!

That is a great idea. 💯 I've updated the spreadsheet with my assignments. Now the translation process should be more transparent. Please place the spreadsheet link to the issue description for better visibility.

starostinak commented 1 year ago

Hey, I also want to contribute 👋 Will look though the translations guide and pick something unclaimed from the spreadsheet.

starostinak commented 1 year ago

I've claimed day 2 morning in the spreadsheet.

gorodnev commented 1 year ago

hello, I'm interested in this activity as well. I'd take the 'bare-metal' chapter of the book.

mgeisler commented 1 year ago

Thanks @starostinak and @gorodnev! I suggest starting small to get familiar with the infrastructure.

Makarevich commented 11 months ago

I just checked the assignment sheet and realized that the list of files in the column A is quite obsolete and I suspect that some of the translations need to be updated as well. (There are certainly quite a few "fuzzy" entries in the ru.po, which need to be updated.) Would it make sense to track the assignments by chapter instead: Intro, Day 1: Morning, Day 1: Afternoon, etc?

mgeisler commented 9 months ago

Hey folks, just a heads up that we're tinkering with publishing the course as a PDF — including for the translations: #1572.

If you have input on the font to use, please let us know!

jnovikov commented 9 months ago

Hi. I want to contribute to this effort. Should I just add myself to the sheet and assign some pages there ?

henrif75 commented 9 months ago

Hi. I want to contribute to this effort. Should I just add myself to the sheet and assign some pages there ?

Hi @jnovikov! You can follow the instructions on https://github.com/google/comprehensive-rust/blob/main/TRANSLATIONS.md. I believe the assignment sheet is obsolete, given it was unchanged for quite a while and the Comprehensive Rust material was substantially updated. My suggestion to you is to either update the sheet or you start a PR, adding here what are you intending to do. Thank you!

1dimir commented 6 months ago

Hi! It seems that I'm in. And I have a few questions.

What is the desired granularity of pull requests? From my point of view the translation task could be split into three stages. First one is to make all pages readable in Russian: translate everything that should be translated. Second, re-read, refine and rephrase section-wise. Third, collect some meta-information, remove obsolete translations and flags. So is it OK to pull really small changes until we start refining? Or I just try and see how it goes?

PO files format supports translator comments. I started using them quite extensively. Noting, why was a particular translation used, what possible alternatives were there etc. It may seem to duplicate pull request discussions, but having it in po comments will keep the context for future reviews. E.g. I would also put there some summary of concurrency terminology discussion from past changes. Am I not misusing the tool feature?

What is the right place to ask tiny questions regarding the source material? If it isn't worth starting a new Discussion. E.g. we have two Hello, World! titles, one is about the first program and another could have a title: Hello Rust as it's about the language introduction.

mgeisler commented 6 months ago

PO files format supports translator comments. I started using them quite extensively. Noting, why was a particular translation used, what possible alternatives were there etc. It may seem to duplicate pull request discussions, but having it in po comments will keep the context for future reviews. E.g. I would also put there some summary of concurrency terminology discussion from past changes. Am I not misusing the tool feature?

I think that's a great idea! In general, I've tried to not be prescriptive in how people use the PO files, but I think it's a nice idea to document past discussions like you suggest.

Longer-term, I think we should switch to a translation platform, #1305. That might remove the need for PO files completely if it becomes the source of truth. I could also imagine letting the PO files be the source of truth and then synchronize them to the platform (and make PRs to the PO files when exporting from the platform). Regardless, most platforms will likely support some form of translation comments.

mgeisler commented 6 months ago

So is it OK to pull really small changes until we start refining?

Yes, I would encourage that! I've seen in other languages that it's much easier to review and merge small PRs.

There are a few challenges in translating the course: a big one is the human aspect of finding someone who is motivated to do the work of translating and reviewing. Making the PRs small helps here since it makes it easier to merge uncontroversial translations.

What is the right place to ask tiny questions regarding the source material? If it isn't worth starting a new Discussion. E.g. we have two Hello, World! titles, one is about the first program and another could have a title: Hello Rust as it's about the language introduction.

You are welcome to create issues for things that look like bugs or where you have ideas for improvements — discussions are probably more for open-ended, well, discussions. We don't have a super strict separation :smile:

You're also very welcome to simply create a PR whenever you spot something weird in the source text. I'm not a native English speaker, so there are still some typos and inconsistencies hidden here and there.