Translate Documentation

[sergiohermes]

Hi, Tom. How are you?

  ZF\Oauth2\Doctrine, has had a lot of value in the projects that I develop and somehow I would like to be able to help. Since it helped me a lot, I wish that other people could use it or even learn the flow.

I often translate repositories that have a good interest among the community. I understand that English is an official language, but nothing better than having documentation in several languages, this certainly covers more.

So is it ever possible to generate a place where it contains translations? I understand that a well documented api is fundamental for it to be consumed and improved.

For example:

doctrine-in-apigility-docs.readthedocs.io/en/latest/zf-oauth2-doctrine/index.html doctrine-in-apigility-docs.readthedocs.io/pt-br/latest/zf-oauth2-doctrine/index.html doctrine-in-apigility-docs.readthedocs.io/any-locale/latest/zf-oauth2-doctrine/index.html

Is a possible?

Cheers

[TomHAnderson]

Hi Sérgio, I would love to get some translations for doctrine-in-apigility. Anything you can do would be appreciated.

In order to create a translation I need a repository like https://github.com/API-Skeletons/doctrine-in-apigility-docs For each language we create a repository named "doctrine-in-apigility-docs-en-US" with the language and locality appended (I'll end up renaming this one when we have translations to this -en-US). You don't need to translate the whole documentation and starting with zf-oauth2-doctrine is fine.

I'll gladly set you up with repositories to translate if you tell me the language and localities you want to translate into. You can then clone the repository and submit pull requests with your translations.

I'm excited for this! Thank you! Tom

On Fri, Sep 29, 2017 at 11:44 AM Sérgio Ernane Munhós Hermes < notifications@github.com> wrote:

Hi, Tom. How are you?

ZF\Oauth2\Doctrine, has had a lot of value in the projects that I develop and somehow I would like to be able to help. Since it helped me a lot, I wish that other people could use it or even learn the flow.

I often translate repositories that have a good interest among the community. I understand that English is an official language, but nothing better than having documentation in several languages, this certainly covers more.

So is it ever possible to generate a place where it contains translations? I understand that a well documented api is fundamental for it to be consumed and improved.

For example:

doctrine-in-apigility-docs.readthedocs.io/en /latest/zf-oauth2-doctrine/index.html doctrine-in-apigility-docs.readthedocs.io/pt-br /latest/zf-oauth2-doctrine/index.html doctrine-in-apigility-docs.readthedocs.io/any-locale /latest/zf-oauth2-doctrine/index.html

Is a possible?

Cheers

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/API-Skeletons/doctrine-in-apigility-docs/issues/1, or mute the thread https://github.com/notifications/unsubscribe-auth/AAeJYAuxtXncyfhChGtjFO5vrSQnwubrks5snSwPgaJpZM4Po_RR .

[sergiohermes]

Hello Tom, I think the doctrine-in-aptitude-docs-pt-br with your namespace preference.

Thinking a little out of the box, Tom would be the perfect idea if it were possible even the API responses! WOW!

 ... or open a front that promotes this.

Implementing something of the genre! https://github.com/mikicaivosevic/zf2-translate-plugin

Translated documentation is as important as the translated answers.

The programming flow should be in EN, but the answers need to be abstracted. That brings value to the project, I think. So I understand your concern in the English translation of the US as ours! There is a large linguistic variable in English.

Home	Country / Region	Proposal
Portuguese	Brazil	✓
Portuguese	Portugal	x

Home	Country / Region	Proposal
English	Australia	x
English	Belize	x
English	Canada	x
English	Caribbean	x
English	Ireland	x
English	Jamaica	x
English	New Zealand	x
English	Republic of the Philippines	x
English	South Africa	x
English	Trinidad and Tobago	x
English	United Kingdom	x
English(Default English Locale ID)	United States	✓
English	Zimbabwe	x

I think you have a choice.

I believe that after I clone, it will be salegria ... Hope so. xD I feel happy to be able to help. Pleasant dreams and Hands on.

[sergiohermes]

I swear I had not seen it as a new repository hahaha.

I'm going to go for this same hug

[TomHAnderson]

Sergio, I will create the repositories you can work with if you tell me the languages you want. We don't need the locality as I initially thought. So, in english, which language(s) would you like to translate to?

[sergiohermes]

I intend translating into portuguese from brazil