Translation of Content (and the Infra migration) and Nodejs.dev

[ovflowd]

As we're going towards the path of over the time switch the layout and content from nodejs/nodejs.dev (Node.js Website Redesign) over here, I find myself questioning, what about existing pages on the nodejs/nodejs.dev and that also exist here. For example, the get-involved, about, and other pages.

Obviously, we have more existing translations here, but after doing some inspection, many of the translations need to be updated or doing funky things inside. (For example, the PT-BR translations have both English and Portuguese versions inside the Markdown files, but the English ones are commented).

Would this be an opportunity to "reset" the translations? Start over? Or should we keep the existing pages from nodejs.org instead of replacing conflicts with the ones from nodejs.dev? (Further explaining, if a page exists on both repositories, we choose to use the one from nodejs.org, and all remaining pages that do not exist on nodejs.org will be copied from nodejs.dev, such as the learn pages).

There are a few paths here:

1. For all pages on nodejs/nodejs.org and nodejs/nodejs.dev we choose the ones from nodejs.dev, effectively resetting the translations.
   1. Route 1: And all remaining content stays translated as it is.
   2. Route 2: Or, all the remaining translated content already gets their translations removed, so we start over from translations.
2. For all pages on nodejs/nodejs.org and nodejs/nodejs.dev we choose the ones from nodejs.org, only adding to nodejs/nodejs.org the content that only exists on nodejs.dev but not on nodejs.org.
   1. Route 1: And we keep the translations as they are
   2. Route 2: Or we nuke the remaining translated content and start the translations from scratch.
3. Either Option 1 or Option 2 with the difference that instead of nuking translated content, we manually investigate all outdated translations or with funky content within their Markdowns (Either manually via GitHub's UI or maybe if Crowdin supports a diff tool, via Crowdin).

Regardless of the options, translations should be done via Crowdin, as it has an idiomatic IDE (online) for translations and a better translation review system that could prevent such funky divergences from happening.

Off-topic question: I also wonder if Crowdin supports versioning, meaning if a source translation file gets updated, it automatically requests the other translations to be updated/re-reviewed.

--

cc @Trott @nodejs/website @nodejs/i18n @nodejs/nodejs-dev

[AugustinMauroy]

For me it is necessary to take all the content of nodejs.dev and put it on nodejs.org without looking at what has been done on nodejs.org in the past. But take the translation already done on nodejs.dev (fr, ja , he ...). I know it's barbaric and sad.

But it is necessary. Because it allows you to start again on a good basis.
Another point is that the file structure will change. This allows to have the same contents (in different languages) in the same directory. This allows to maintain the contents more easily. It avoids having files that are out of date.

I can understand that my point of view is difficult to hear because it is radical. I understand that we are against this point I myself have worked on the translation of nodejs.org in French.
But we have to move forward so the deletion of this amount of files is necessary in my opinion.

[Trott]

I'm in favor of whatever is easiest/quickest to do right now in terms of getting the merge/migration/whatever of nodejs.dev and nodejs.org completed unless doing so makes it harder to do translations in the future. Basically, whatever is the least work for @ovflowd and anyone that might have to do work on the Build WG side.

[joesepi]

Thanks to all working through these thorny issues.

I have some questions:

• @AugustinMauroy mentions "the file structure will change". I am under the impression that the goal is to not break any old links. Is the file structure changing? Does that mean links will break?
• In terms of the translations, do we know about how many pages we are talking about? That would be helpful in determining the path forward.

I think something of a reset isn't a terrible option. Sometimes you have to break all the eggs to make an omelette? If there is an announcement on the change over, we could use it as an opportunity to reinvigorate translation efforts.

[ovflowd]

@AugustinMauroy mentions "the file structure will change". I am under the impression that the goal is to not break any old links. Is the file structure changing? Does that mean links will break?

All links will work as the same. The source file structure changed, basically instead of all pages residing within /locale/ they will inside /pages/, but no worries, all links should be respected and be the same (I'm being extremely careful with that)

In terms of the translations, do we know about how many pages we are talking about? That would be helpful in determining the path forward.

How many pages are currently translated?

If there is an announcement on the change over, we could use it as an opportunity to reinvigorate translation efforts.

Agreed :) and now I want an omelette haha

[AugustinMauroy]

How many pages are currently translated?

you can have a % with crowdin

[nschonni]

How many pages are currently translated?

you can have a % with crowdin

Crowdin isn't used for the current website translation efforts, so any percentage from their dashboard is likely incorrect. EX: it could say 0%, but the bulk of the content was translated through PRs, but not marked as translated on their system

[ovflowd]

@nschonni the % should reflect on what files are mapped inside the %two letter code% folders and maybe with the revision of translation? But I'm not sure.

[nschonni]

Yeah, I haven't looked at it in awhile, but looking now, it seems like the accepted vs translated are 2 separate numbers now

[ovflowd]

Yeah, I haven't looked at it in awhile, but looking now, it seems like the accepted vs translated are 2 separate numbers now

Hmmm, interesting. Also to mention, on the current initial infra PR, I'm deleting all untranslated files residing inside the translated folders, because... Well, what's the point? More stuff to build.

[nschonni]

That's probably OK for your dev cycles, but those files were approved/edited by the language groups through direct PRs to the repo, and likely shouldn't be thrown away.
I think the current folder approach here and also shown in nodejs/nodejs.dev#3150 is better than the suffix approach

[ovflowd]

That's probably OK for your dev cycles, but those files were approved/edited by the language groups through direct PRs to the repo, and likely shouldn't be thrown away.

As I mentioned, the files I deleted are the same as the English ones (untranslated). There's no point of having untranslated files inside translated directories 🤔

I think the current folder approach here and also shown in nodejs/nodejs.dev#3150 is better than the suffix approach

We're making the suffix approach right now because the initial PR/migration will be full SCG and we want to reduce the amount of file structure changes.

In the future, all these files are actually going to be thrown away (if we decide to use the files on nodejs.dev) which is what we're deciding in this issue.

[nschonni]

Ah, if you're just wiping out the English files copies, that's great! There was an issue around cleaning those up awhile ago, but I don't think it got finish.
FYI, I think they originally got imported/created by Crowdin when we first set it up 😆 , so something to watch out for