Translate to pt-BR (Portuguese Brazil)

[vitornogueira]

I want to start translating to pt-BR (Portuguese Brazil), how do I add my fork in GitLocalize?

Fork Link: https://github.com/devtranslate/docs

[ErickPetru]

@vitornogueira there are guys actually planning this translation at vuejs-br comunity. Do you want to join us?

[ErickPetru]

@atinux can you add Portuguese (Brazil) to the GitLocalize translate list or should we go by ourselves forking this repo like we do in the main Vue.js docs?

[vitornogueira]

Nice! We fork the repository to devtranslate organization (https://github.com/devtranslate/docs). Can we work on that fork or will it have a fork for the @vuejs-br?

[andrevandal]

@vitornogueira Vue Brazilian Community is centralized on VueJs-Br organization. Do you mind keeping the repository there?

[atinux]

Hi there, it's awesome to have Brazilian translation coming!

I believe it's better to fork the repository so you can stay in sync with master branch, I think @haeresis can explain more about his process which is really good

[vitornogueira]

Hi @derevandal. If you want we can work on the fork of the @vuejs-br organization, no problems 😉

[ErickPetru]

@vitornogueira, the fork https://github.com/vuejs-br/nuxt-docs is waiting for you.

@atinux, we already work this way with the vuejs.org repo. But how you'd like to receive our updates to deploy, maybe pull requets of the pt-br folder to the main repo?

[atinux]

Pull requests to thr pt-br folder will be perfect :)

[vitornogueira]

Thanks @ErickPetru

[andrevandal]

Thanks all.
@ErickPetru could u add your fork in GitLocalize?
Or u should wait @haeresis and @atinux?

[MachinisteWeb]

We do not use GitLocalize accross our Vuejs-FR process but we have a process to translate and review all togheter and better, a process to see all changes from last translation update to set up-to-date the documentation with English version. If you do not want use GitLocalize or if you not already have a process I can explain our process (or find post where I explain it) :) Let me know if it's useful now or let me know that later ;)

Good Luck ;)

[andrevandal]

@haeresis thanks bro! now, we fork this repo, clone en folder and start translate making pl on your fork. what process do u use?

[MachinisteWeb]

Principe alone

Manage your translation into two branch on your translation project your fork from nuxt/docs.

1. The master branch will be reserved to propose PR from <your-repo>/docs:master to nuxt/docs:master.
2. The working branch into which you will translate into en directory directly from EN to PT.

Your working branch will be upstreamed from nuxt/docs:master. That means each time an update will be done into the original en directory from nuxt/docs:master, a conflict will appear in your <your-repo>/docs:working at the same already translated file and line. That allows you to track all update in future, and update it.

When the <your-repo>/docs:working EN directory is enough translated / updated, you copie/past the en content into the pt directory of <your-repo>/docs:master. From now just do a PR <your-repo>/docs:master to nuxt/docs:master to update pt in orginal fork.

Work with a team

To allows more one person to translate files. Each translator should create it's own fork from <your-repo>/docs:working, translate the wanted file, and do a PR to <your-repo>/docs:working. That will allows all teams to review the PR and see line by line what EN line is become an PR line (and correct error translation/typo).

Example in french:

• This is the original repo/branch/dir: https://github.com/nuxt/docs/tree/master/en
• We do some git fetch updtream from the original repo to our working repo https://github.com/vuejs-fr/nuxt/tree/working/en.
• All already translated line will do conflict when we dou git merge working upstream/master
• To correct conflict or continue to translate, I do my fork : https://github.com/Haeresis/nuxt/tree/master/en and translate here
• When all is ok I do PR to https://github.com/vuejs-fr/nuxt/tree/working/en. We can review together file (e.g. Translation of all api/internals-*.md files vuejs-fr/nuxt#30)
• When we have review translation or update we merge PR to https://github.com/vuejs-fr/nuxt/tree/working/en
• When enough changes are done, we copy/past https://github.com/vuejs-fr/nuxt/tree/working/en to https://github.com/vuejs-fr/nuxt/tree/master/fr
• Finally we do a PR to https://github.com/nuxt/docs/tree/master/fr
• And so on

Caveat

Normaly, it forbidden to directly update fr from original Nuxt depo because we not track fr directory but en directory. That means it's possible we erase some update do in fr directly. So it's important to do all FR fix/update into https://github.com/vuejs-fr/nuxt/tree/working/en (the real FR tracked version). It's the same for you. So that should be the same for pt

[debs-obrien]

Thanks for your contributions. We are now closing this repo as docs have now moved to nuxtjs.org using content module. Please continue your contributions on that site especially focusing on the guides folder which is the new docs. Thanks

https://github.com/nuxt/nuxtjs.org/blob/master/README.md