Skip to content
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

Help translate Iris into your language #796

Open
speedwheel opened this Issue Oct 24, 2017 · 6 comments

Comments

Projects
None yet
5 participants
@speedwheel
Copy link
Contributor

commented Oct 24, 2017

Dear fellow gophers, Iris users and lurkers, we are all lucky to be here and use this wonderful go framework called Iris.

I am glad to see that Iris has grown into a mature software that is used and trusted by many of us in our projects, from small individual developers to large teams.

There have been a lot of good changes lately that made Iris more powerful than ever before (and this is just the start), easy to use, but in the same time and with very good performance.

But in my opinion the most important thing what makes Iris truly different from other frameworks, is its documentation, which is very important for the our user base, especially for newcomers. And Iris docs are doing a tremendous job explaining all the aspects of the framework with it's documentation by using
a big variety of examples.

Now having all that said, let's move to the "issue" part for this ticket.
I already mentioned that the documentations are plain awesome, but only if you understand english!
Now let's point out the second most used spoken language by Golang devs, well I think you already know of whom I am talking about... you probably already guessed, it's the Chinese users!

I have also noticed myself that more and more Chinese users are opening different issues here and probably many of them looking around trying to grasp and get a hold of using Iris, but unfortunately the language barrier stops them from achieving that, since we all know that a very small percentage of China's population actually speaks english.

But we don't stop here! All Iris users from all over the world can give a hand by helping with translation in there native language!

So by all means I am making a call to all Iris users here that know English + different language and want to help and make Iris a more welcoming place for there fellow compatriots by translating as much as they can of the Iris project.

Now let's get down to business and see what exactly I mean by that. These are the main things that need to be translated, ordered by priority:

  1. https://github.com/kataras/iris - there areo two .md files that need to be translated: README.md and HISTORY.md, please submit a PR for this with the following file naming: README_$LanguageCode.md and HISTORY_$LanguageCode.md (i.e. README_ZH.md, HISTORY_ZH.md a list of language codes by country );

  2. https://github.com/kataras/iris/tree/master/_examples - there is one .md file here that needs to be translated, README.md, please submit a PR for this with the following file naming: README_$LanguageCode.md;

  3. https://iris-go.com/ - here I decided to make a new website using the .cn TLD, so the final domain name will be "iris-go.cn", where we will be adding the same information from iris-go.com, but translated in Chinese.

Also a good thing to keep in mind if you want take part to this, is to check also the English version for mistakes doing the translation process.

Let's all build a better web together, that's what open-source it's all about!

Translations to do:

kataras added a commit that referenced this issue Oct 26, 2017

kataras referenced this issue Oct 27, 2017

@unreadable

This comment has been minimized.

Copy link

commented Oct 28, 2017

There's more english speaker in China than USA...I don't know where you found that small percentage oO. Either way, PRs are wellcome ;)

@speedwheel

This comment has been minimized.

@speedwheel speedwheel changed the title To all Iris lovers Help translate Iris into your language Nov 10, 2017

Repository owner deleted a comment from a233894432 Nov 21, 2017

@Zeno-Code

This comment has been minimized.

Copy link
Contributor

commented Jan 2, 2018

@kataras
I think Beego's STAR far more than IRIS, in addition to release time earlier, another reason is that a large number of Chinese users

I have a question
I need 100% according to the original translation, or can delete some unnecessary statements according to the Chinese situation

My English need to use Google translate, please forgive me

But I've been relatively familiar with IRIS and I can translate relatively authentic Chinese

If there is a translated version of xxx.md, I suggest adding a link to xxx_ZH.md at the top of xxx.md

@kataras

This comment has been minimized.

Copy link
Owner

commented Jan 2, 2018

Yes @Zeno-Code, Iris is just 1 and a half years, beego is 5 years I think and I don't know how many authors beego has but Iris has only one. Beside that fact, Iris is far better than beego or any alternatives for both performance and features, you should know this already, we have many old beego users using iris now... I'm doing my bests and sometimes I have help from people like you, especially on bug reports, translations and english grammar fixes and I am really very thanful for this.

About the translation, yes I'll add these links for HISTORY_ZH.md (you've just created) and README_ZH.md (you've just updated) to the english README.md and HISTORY.md files as well, just tell me when you finish them, and yes you can remove any unnecessary parts from the original file, do it as much naturally as you want, it's totally fine with me!

@TechMaster

This comment has been minimized.

Copy link

commented Jan 14, 2018

Hi Kataras,

We are going to create a online training course how to develop web application using Iris Framework. Language will be Vietnamese.

The course will be released partly in Feb 2018 and completed in April 2018.

@kataras

This comment has been minimized.

Copy link
Owner

commented Jan 14, 2018

Hi @TechMaster,

That is awesome! The whole community will be glad to help you, including me, if you need any help while creating the course.

This was referenced May 26, 2018

@kataras kataras pinned this issue Apr 14, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.