single-spa.js.org icon indicating copy to clipboard operation
single-spa.js.org copied to clipboard

Missing Portuguese (Brazil) translation support in documentaton

Open saratiedt opened this issue 3 years ago • 6 comments

It is a widely spoken language and would help to lower entry barriers for many Brazilian developers.

saratiedt avatar Dec 03 '21 18:12 saratiedt

Hi @saratiedt, can you help with the Portuguese (Brazil) translation? Do you know anyone else who can help with the translation? We prefer having at least two people helping with the translation.

For reference, here was the issue for adding the Russian translation: https://github.com/single-spa/single-spa.js.org/issues/369

Here's the checklist for what needs to be done. Once we confirm there are at least two people willing to help with the translation, I'll start doing them.

Tasks for me

  • [ ] Decide on a language code to use. I think that pt-br might be good?
  • [ ] Create a new repo called pt-br.single-spa.js.org. Manually initialize it to be the same git tree as single-spa.js.org. Do not do this by forking the repo -- a fork has a separate git tree. You can do this by initializing to empty repo (no readme, no gitignore) and then adding that as a remote to your local copy of single-spa.js.org:
cd single-spa.js.org
git remote add pt-br [email protected]:single-spa/pt-br.single-spa.js.org.git
git push pt-br master:master
  • [ ] Update docusaurus config to correct domain (example at https://github.com/single-spa/ru.single-spa.js.org/commit/b8097893831736e3920d8d22a528c4f2458cbfad)
  • [ ] Update CircleCI badge in readme to correct url (example at https://github.com/single-spa/ru.single-spa.js.org/commit/e6660e0cdd2afb7c340b5362240d8f2f15721f76)
  • [ ] Enable builds in CircleCI. Add the GITHUB_TOKEN env variable
  • [ ] Modify /website/static/CNAME in to be the correct domain. https://github.com/single-spa/pt-br.single-spa.js.org/commit/7bd77eb4e50f607dbbb32faca64db052feb0ce3e
  • [ ] Force HTTPS in the repository settings in Github. This takes a day or so after the CNAME is set for the SSL cert to be set up.
  • [ ] Create a pull request to the js.org repo, adding the subdomain. Should be similar to this: https://github.com/js-org/js.org/pull/3747
  • [ ] Add Indonesian to translations.js, so that it appears in the list at https://single-spa.js.org/languages

Tasks for @saratiedt

  • [ ] Find at least one other person who can help with the translations.
  • [ ] Watch the pt-br.single-spa.js.org Github repository for all activity
  • [ ] Translate the files /website/versioned_docs/version-5.x directory. Do not translate the /docs directory. Also, translate each of the pages in /website/pages

Tasks for @guguji5

  • [ ] Set up the bot to automatically commit to pt-br.single-spa.js.org whenever a PR is merged into single-spa.js.org.

joeldenning avatar Jan 04 '22 21:01 joeldenning

Can I join in?

zeyuri avatar Feb 11 '22 01:02 zeyuri

Hi @zeyuri, sure, do you know of one more person who can help?

joeldenning avatar Feb 18 '22 23:02 joeldenning

Hi! I can help too!

vinny-silveira avatar Aug 25 '22 20:08 vinny-silveira

I'm available to help

cleissonbarbosa avatar Aug 21 '23 12:08 cleissonbarbosa

I can help with this task too :)

jeanmalves avatar Nov 15 '23 01:11 jeanmalves