Portuguese translation
SandroMiguel opened this issue · 18 comments
Can I help with portuguese (Portugal) translation?
@SandroMiguel Welcome aboard! It can be amazing to have a Portuguese version
I'm sharing here instructions how usually we kick-off a translation, is this descriptive enough? do you want to take it alone or join others?
Open a branch - each translation is done on a dedicated branch that is PRed to master upon completion
Duplicate pages - the content should be translated over a page duplication. Readme.MD became Readme.port.MD, all other files should be duplicated similarly. So the number of English & Portuguese pages should be the same. Will create a bold link from the English home page to the Portuguese home page (with your name on top of it...).
Keep the same content & formatting - the focus is on translation, should anyone want to modify the content or the graphics - let's PR first in English and them translate
Your name will be on the top of the Portuguese page.
What do you think?
Great! I can do this myself, but if someone wants to help, it's better and faster.
Page duplication: I can create the Readme.port.MD but what do you think about README.pt-PT.md? It's more explicit with ISO 639-1 + ISO 3166-1-alpha-2. In future we can have README.pt-BR.md to Portuguese-Brazil translation.
Sounds like the right way to do it. Someone can help in copying all the pages, but as for the translation itself we have to seek Portugese speakers, I can ask on Twitter + open issue @SandroMiguel
In terms of UX, we don't have languages links per bullet rather per the whole repo, so when a visitor opts to read the Portugese version he will be disappointed if 90% is in English. If we continue with this model, we should translate at least the home page.
Maybe we should consider creating translation links per item than it will be easier for people to transalate shorter items? @idori what do you think?
Follow the nodepractices twitter, I'll tweet today. Are there any Node Portguese FB groups to ask in?
I think it's more confusing to create translation links per item.
@SandroMiguel Than does it resonate with you that at least the home page should be translated?
Hello @i0natan,
Yes, it makes perfect sense. When I finish the translating the homepage I'll make a PR.
@SandroMiguel @i0natan I'm Brazilian and I can help with the pt-BR translation. It'll be easier to translate from the pt-PT translation.
Hello @herodrigues, you can start translate from here https://github.com/SandroMiguel/nodebestpractices/blob/master/README.pt-PT.md
Already translated up to 2.1
@SandroMiguel @herodrigues Cool, let me know if I can help with anything
Hi @i0natan, should I put the Portuguese flag in "Translations in progress". I'm still translating this repository myself.
@SandroMiguel Is the majority of the 1st page translated or at least the upper part? if so, sounds like a great idea
@sagirk Assigned to you so you can experiment a translation issue once. If your plate is full, feel free to bounce back to me
@sagirk 👋
Hello there! 👋
This issue has gone silent. Eerily silent. ⏳
We currently close issues after 100 days of inactivity. It has been 90 days since the last update here.
If needed, you can keep it open by replying here.
Thanks for being a part of the Node.js Best Practices community! 💚