Opensource.guide: Process for keeping translations up to date

[katrinleinweber]

How about we collect some advice in docs/translations.md under Keeping translations up to date or similar?

Working on #1118 I naively scrolled through the commit list and looked at merge commits that seemed to add content. Would git diff $translation_branch master _articles/*.md or similar be better?

[MikeMcQuaid]

This seems like a good idea. Could you submit a PR with your recommended workflow?

[katrinleinweber]

The snake seems to be eating its tail: #1121/files#diff ;-)

I'll revisit this in a few days once there is a difference between my translation_branch& upstream/master to check whether the above initial idea is viable.

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[katrinleinweber]

This is a tough nut. I tried the following today:

1. Copy ID of last own commit in _articles/de.
2. git switch master && git pull upstream/master
3. git diff --word-diff $LAST_OWN upstream/master _articles/*.md > TODO-translate.txt
4. git switch $translation_branch
5. git rebase master
6. Go through TODO-translate.txt & implement the English source's changes accordingly in the _articles/**/*.md translation(s). Because of the "own commit" step initially, one will sometimes notice already implemented changes by other translators. Skipping those seems less problematic, than remembering to only update the translation_branch _after_ diffing.

[webknjaz]

@katrinleinweber FWIW this is something I suggested a while back: https://github.com/github/opensource.guide/issues/288#issuecomment-283927635. It'd be nice to have it fully scripted so that it'd be easier to automatically check it...

[katrinleinweber]

Yeah, that might be a more convenient step 1., but it would require each translation session to cover all of the English updates, wouldn't it?

Because those can occur in parallel to minor translation updates (correcting links, wording, or spelling), there is a risk of overlooking significant English updates that occured before such a minor update's SHA is recorded in the translation metadata, no?

[popcorner]

What about considering using some professional translate tools instead of using Git directly?
Git is powerful but not the best tool for translating articles. Contributors have to use additional steps to check the difference, and it seems hard to automatically merge new contents into translation. And, The smallest unit of Git comparison is the lines, not sentences. These problems mean additional manual work.
But these professional translate tools like Transifex, Crowdin, and Weblate can do these things automatically, with lots of additional features. They can cut articles into sentences and track all the modifications of source articles. They can handle all the issues about translation from minor changes to new articles. Translators only need to translate all the sentences that marked as "need to be translated", and all the other things like generating the translation files can be done by the platform. And these tools can also help check the translation itself, like machine translation hints, word lists to keep the same word to have the same translation, and similarity check to help translators see the existing translation from these similar sentences and avoid duplicate work. These platforms can work with Git and commit changes, and all the other workflow won't be affected. These tools provide free services to open source projects, so maybe it's a good idea to consider using these platforms to make the translations easier to maintain.

[MikeMcQuaid]

What about considering using some professional translate tools instead of using Git directly?

This is being discussed in https://github.com/github/opensource.guide/issues/1133 and is on my list to investigate further (hopefully over Christmas).

[popcorner]

@MikeMcQuaid That tool seems to be different from the platforms I suggested. GitLocalize looks like a lightweight translation tool working with Git, and what I suggested are professional translation platforms with lots of additional features. And these platforms are more famous (according to the number of search results) and their documents are better.
For example, https://github.com/github/opensourcefriday are using Transifex. Maybe you can try to visit their project and see which type of tool is more suitable for this repository.

[MikeMcQuaid]

For example, https://github.com/github/opensourcefriday are using Transifex. Maybe you can try to visit their project and see which type of tool is more suitable for this repository.

I created the translation solution for both this project and Open Source Friday. The Transifex/Open Source Friday solution is unsuitable here as this repository is a Markdown document-based translation flow rather than lots of small strings.

https://github.com/github/opensource.guide/issues/1133 will be the next investigation and, if it seems an improvement on what we currently have, will be the next method of translation for this repository.

[137717unity]

https://www.openarchives.org/rs/0.9.1/resourcesync

[smpbl]

GOOD

[horace1981]

Hi

[Jun6plushub]

1119

[bigwill1200]

How about we collect some advice in docs/translations.md under Keeping translations up to date or similar?

Working on #1118 I naively scrolled through the commit list and looked at merge commits that seemed to add content. Would git diff $translation_branch master _articles/*.md or similar be better?

You are right

[bigwill1200]

Yes

[ghost]

gi

[kbptomo2020]

mention: keithbrianptomo

[Felipescolari]

How about we collect some advice in docs/translations.md under Keeping translations up to date or similar?

Working on #1118 I naively scrolled through the commit list and looked at merge commits that seemed to add content. Would git diff $translation_branch master _articles/*.md or similar be better?

[spiritualconnection3]

The process for either has its own individual guidelines and or application
techniques that must be applied correctly to the the array as well as root
depending on if the code is consistantly progressing in transition vs
evelutionary progress used in patching older to newer. In the event that
isn't possible, it may be that the solution may be more complicated than
needs to be. Try a simple fork patch. Basically apply a fork at the
transition. Let me know what you think and /or if it solves the glitch.
Hope that helpselps.

On Sat, Aug 22, 2020, 1:41 AM Felipescolari [e-mail]
wrote:

How about we collect some advice in docs/translations.md
https://github.com/github/opensource.guide/blob/7b5aebc02a71b1f9f62873757a0643c0668612bd/docs/translations.md
under Keeping translations up to date or similar?

Working on #1118 https://github.com/github/opensource.guide/pull/1118 I
naively scrolled through the commit list
https://github.com/github/opensource.guide/commits/master and looked at
merge commits that seemed to add content. Would git diff
$translation_branch master _articles/*.md or similar be better?

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
https://github.com/github/opensource.guide/issues/1119#issuecomment-678603934,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/APFMOXWNCIIPZAN4MYXI7GTSB5R75ANCNFSM4I3JD5PQ
.

[hussenasseb]

Stop

[ding243]

Hello world

[toomoon1979]

Can you help me to watch iptv for word Chanel. If any one can get me how can download iptv m3u link Iam very thankful for get me that .
Regarding your

[Paola954]

https://github.com/github/opensource.guide/issues/1119#issuecomment-697133532

[mmoo301]

1741 #1119

[Alibhutta24]

This seems like a good idea. Could you submit a PR with your recommended workflow?

Quite

[Alibhutta24]

1741 #1119

Quite

[Alibhutta24]

#1119 (comment)

Quite

[Alibhutta24]

Can you help me to watch iptv for word Chanel. If any one can get me how can download iptv m3u link Iam very thankful for get me that .
Regarding your

Quite

[Alibhutta24]

Hello world

Quite

[Alibhutta24]

How about we collect some advice in docs/translations.md under Keeping translations up to date or similar?
Working on #1118 I naively scrolled through the commit list and looked at merge commits that seemed to add content. Would git diff $translation_branch master _articles/*.md or similar be better?

Quiye

[Alibhutta24]

Quite

[Alibhutta24]

Close

[Alibhutta24]

How about we collect some advice in docs/translations.md under Keeping translations up to date or similar?

Working on #1118 I naively scrolled through the commit list and looked at merge commits that seemed to add content. Would git diff $translation_branch master _articles/*.md or similar be better?

QUITE