New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Request for Translations #28

Open
hwclass opened this Issue Mar 21, 2017 · 23 comments

Comments

Projects
None yet
@hwclass

hwclass commented Mar 21, 2017

In some languages like DE, JP, TR, etc.


Edit by donnemartin:

Looking to help with translations? Please review the following information.

Translation process

Hi Everyone,

Thanks for pitching in with the translations!

I'm a big fan of The Art of Command Line by @jlevy. Here's his Contributing Guidelines that I think we could follow:

Translations

We'd like for the guide to be available in many languages. Here is the process for maintaining translations:

  • This original version and content of the guide is maintained in English.
  • Translations follow the content of the original. Unfortunately, contributors must speak at least some English, so that translations do not diverge.
  • Each translation has a maintainer to update the translation as the original evolves and to review others' changes. This doesn't require a lot of time, but review by the maintainer is important to maintain quality.

Changes to translations

  • Changes to content should be made to the English version first, and then translated to each other language.
  • Changes that improve translations should be made directly on the file for that language. PRs should only modify one language at a time.
  • Submit a PR with changes to the file in that language. Each language has a maintainer, who reviews changes in that language. Then the primary maintainer @donnemartin merges it in.
  • Prefix PRs and issues with language codes if they are for that translation only, e.g. "es: Improve grammar", so maintainers can find them easily.

Adding translations to new languages

Translations to new languages are always welcome, especially if you can maintain the translation!

  • Check existing issues to see if a translation is in progress or stalled. If so, offer to help.
  • If it is not in progress, file an issue for your language so people know you are working on it and we can arrange. Confirm you are native level in the language and are willing to maintain the translation, so it's not orphaned.
  • To get it started, fork the repo, then submit a PR with the single file README-xx.md added, where xx is the language code. Use standard IETF language tags, i.e. the same as is used by Wikipedia, not the code for a single country. These are usually just the two-letter lowercase code, for example, fr for French and uk for Ukrainian (not ua, which is for the country). For languages that have variations, use the shortest tag, such as zh-Hant.
  • Invite friends to review if possible. If desired, feel free to invite friends to help your original translation by letting them fork your repo, then merging their PRs.
  • Add links to your translation at the top of every README*.md file. (For consistency, the link should be added in alphabetical order by ISO code, and the anchor text should be in the native language.)
  • When done, indicate on the PR that it's ready to be merged into the main repo.

-Donne

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Mar 22, 2017

Owner

Hi @hwclass, good idea! Tagging as help wanted. The diagrams/images might need some thought on how to best translate (if at all).

Edit: Here's the ticket on making the OmniGraffle diagrams available: #15.

Owner

donnemartin commented Mar 22, 2017

Hi @hwclass, good idea! Tagging as help wanted. The diagrams/images might need some thought on how to best translate (if at all).

Edit: Here's the ticket on making the OmniGraffle diagrams available: #15.

@sqrthree

This comment has been minimized.

Show comment
Hide comment
@sqrthree

sqrthree Mar 22, 2017

Contributor

@donnemartin Awesome document 💯. Could we translate this document into simplified Chinese and share with more Chinese developers, please? We have an organization, and we have translated more than 400 articles. We are looking forward to hearing from you.

About our organization: github.com/xitu/gold-miner/

Contributor

sqrthree commented Mar 22, 2017

@donnemartin Awesome document 💯. Could we translate this document into simplified Chinese and share with more Chinese developers, please? We have an organization, and we have translated more than 400 articles. We are looking forward to hearing from you.

About our organization: github.com/xitu/gold-miner/

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Mar 22, 2017

Owner

Hi @sqrthree, thank you! That would be awesome if you could lead the simplified Chinese translation. Please let me know how I can best support you.

Owner

donnemartin commented Mar 22, 2017

Hi @sqrthree, thank you! That would be awesome if you could lead the simplified Chinese translation. Please let me know how I can best support you.

@emrahtoy

This comment has been minimized.

Show comment
Hide comment
@emrahtoy

emrahtoy Mar 22, 2017

I would like to help for turkish translation @hwclass & @donnemartin 👍
How shell we start ?

emrahtoy commented Mar 22, 2017

I would like to help for turkish translation @hwclass & @donnemartin 👍
How shell we start ?

@hwclass

This comment has been minimized.

Show comment
Hide comment
@hwclass

hwclass Mar 22, 2017

It would be great, @emrahtoy. Yes, how shall we start @donnemartin?

hwclass commented Mar 22, 2017

It would be great, @emrahtoy. Yes, how shall we start @donnemartin?

@donnemartin donnemartin changed the title from Translations to A Call for Translators Mar 23, 2017

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Mar 23, 2017

Owner

Hi everyone, thanks for pitching in with the translations! I updated the original post with a proposed workflow.

Owner

donnemartin commented Mar 23, 2017

Hi everyone, thanks for pitching in with the translations! I updated the original post with a proposed workflow.

@donnemartin donnemartin changed the title from A Call for Translators to A Call for Translations Mar 23, 2017

@IuryAlves

This comment has been minimized.

Show comment
Hide comment
@IuryAlves

IuryAlves Mar 25, 2017

Who wants to translate for brazilian portuguese ? o/

IuryAlves commented Mar 25, 2017

Who wants to translate for brazilian portuguese ? o/

@donnemartin donnemartin changed the title from A Call for Translations to Request for Translations Mar 27, 2017

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Mar 27, 2017

Owner

I added the Translations Contributing Guidelines to help standardize the process.

@hwclass which translation(s) are you interested in tackling?

@sqrthree: #38

@emrahtoy: #39

@IuryAlves: #40

Let me know how I can best help. Thanks everyone!

Owner

donnemartin commented Mar 27, 2017

I added the Translations Contributing Guidelines to help standardize the process.

@hwclass which translation(s) are you interested in tackling?

@sqrthree: #38

@emrahtoy: #39

@IuryAlves: #40

Let me know how I can best help. Thanks everyone!

@hwclass

This comment has been minimized.

Show comment
Hide comment
@hwclass

hwclass Mar 27, 2017

Hi @donnemartin

I can help @emrahtoy for Turkish translations.

hwclass commented Mar 27, 2017

Hi @donnemartin

I can help @emrahtoy for Turkish translations.

@sqrthree

This comment has been minimized.

Show comment
Hide comment
@sqrthree

sqrthree Mar 27, 2017

Contributor

@donnemartin Great. I noticed you are working on OmniGraffle templates, please let us know when you finish it. 😛

Contributor

sqrthree commented Mar 27, 2017

@donnemartin Great. I noticed you are working on OmniGraffle templates, please let us know when you finish it. 😛

@jlevy

This comment has been minimized.

Show comment
Hide comment
@jlevy

jlevy Mar 27, 2017

Cool to see this idea working on new projects! :) Excited to see if you devise any improvements to the translation process.

jlevy commented Mar 27, 2017

Cool to see this idea working on new projects! :) Excited to see if you devise any improvements to the translation process.

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Mar 28, 2017

Owner

@hwclass great, I added you as a maintainer to #39.

@sqrthree will do!

@jlevy thanks for the template and the awesome work on TAOCL! I'll let you know if we come up with any improvements to the translations process.

Owner

donnemartin commented Mar 28, 2017

@hwclass great, I added you as a maintainer to #39.

@sqrthree will do!

@jlevy thanks for the template and the awesome work on TAOCL! I'll let you know if we come up with any improvements to the translations process.

@coderall

This comment has been minimized.

Show comment
Hide comment
@coderall

coderall Apr 10, 2017

i wonder if i can help to translate this great work to Chinese

coderall commented Apr 10, 2017

i wonder if i can help to translate this great work to Chinese

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Apr 10, 2017

Owner

Hi @coderall, thanks for offering to help!

Please check out #38 for the Chinese translation progress.

Owner

donnemartin commented Apr 10, 2017

Hi @coderall, thanks for offering to help!

Please check out #38 for the Chinese translation progress.

@DmitryOlkhovoi

This comment has been minimized.

Show comment
Hide comment
@DmitryOlkhovoi

DmitryOlkhovoi commented Jun 29, 2017

Russian
#87

@tsukukobaan

This comment has been minimized.

Show comment
Hide comment
@tsukukobaan

tsukukobaan Sep 14, 2017

Contributor

Hi! @donnemartin
I've recently found this project and was impressed with its thorough contents!!
I would love to contribute to this by translating it into Japanese.

Contributor

tsukukobaan commented Sep 14, 2017

Hi! @donnemartin
I've recently found this project and was impressed with its thorough contents!!
I would love to contribute to this by translating it into Japanese.

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Sep 15, 2017

Owner

@tsukukobaan thank you!

I added you as a maintainer to #100.

Owner

donnemartin commented Sep 15, 2017

@tsukukobaan thank you!

I added you as a maintainer to #100.

@pgoodjohn

This comment has been minimized.

Show comment
Hide comment
@pgoodjohn

pgoodjohn Sep 18, 2017

Hey guys, great work!
I'd love to help with an Italian translation if you think it might be helpful!

pgoodjohn commented Sep 18, 2017

Hey guys, great work!
I'd love to help with an Italian translation if you think it might be helpful!

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Sep 18, 2017

Owner

Sounds great @pgoodjohn, thanks for the help!

Check out #104

Owner

donnemartin commented Sep 18, 2017

Sounds great @pgoodjohn, thanks for the help!

Check out #104

@Belonias

This comment has been minimized.

Show comment
Hide comment
@Belonias

Belonias Jan 30, 2018

Hi! I would like to help with the Greek Translation

Belonias commented Jan 30, 2018

Hi! I would like to help with the Greek Translation

@donnemartin

This comment has been minimized.

Show comment
Hide comment
@donnemartin

donnemartin Feb 8, 2018

Owner

@Belonias great! I created #130 for you.

Owner

donnemartin commented Feb 8, 2018

@Belonias great! I created #130 for you.

@aminebenamor5

This comment has been minimized.

Show comment
Hide comment
@aminebenamor5

aminebenamor5 Jul 19, 2018

Who want to translate to French translation :)

aminebenamor5 commented Jul 19, 2018

Who want to translate to French translation :)

@Allaman Allaman referenced this issue Jul 27, 2018

Open

German Translation #186

1 of 8 tasks complete
@omer-demir

This comment has been minimized.

Show comment
Hide comment
@omer-demir

omer-demir Aug 13, 2018

@hwclass @donnemartin for Turkish translation, do you guys need extra help?

omer-demir commented Aug 13, 2018

@hwclass @donnemartin for Turkish translation, do you guys need extra help?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment