You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: TRANSLATION.md
+27Lines changed: 27 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -96,3 +96,30 @@ Translations are synced between Crowdin and the repository via GitHub Actions.
96
96
- Via a cron schedule, and as needed manually by a collaborator, we download completed translations.
97
97
98
98
Incoming translations are linted to ensure they come from crowdin, and are also formatted to adhere to our project settings.
99
+
100
+
## Why We Translate This section and Not That Section
101
+
102
+
> First, what we mean by "section" is a part of the website. It's a collection of pages that are related to each other. They often correspond to the top-navigation of the site. For example, the "Learn" section is a collection of pages that are related to learning/discovering Node.js.
103
+
104
+
Here we only talk about md/mdx files. The translation of React components is covered by a JSON dictionary and not covered here.
105
+
106
+
We have these sections on the website:
107
+
108
+
- Home page
109
+
- Learn
110
+
- About
111
+
- Download
112
+
- Blog
113
+
- Docs (not this codebase at all)
114
+
115
+
### Sections that are translated
116
+
117
+
-**Home page**: The landing page is translated because it's the first page that people see when they visit the website. It's important that everyone can understand what Node.js is and what it can do.
118
+
-**About**: This section is translated because it contains information about the Node.js project, its governance. There are no technical terms that are hard to translate.
119
+
-**Download**: This section is translated because it contains information about how to download Node.js. And it's really important that everyone can understand how to download Node.js.
120
+
121
+
### Sections that are not translated
122
+
123
+
-**Learn**: Per TSC consensus, the learn section is not translated. It contains technical terms that are hard to translate. Maintainers do not have the ability or bandwidth to ensure quality. It's better to have the content in English than to have bad translations. If you want to have more information read [this message](https://github.com/nodejs/nodejs.org/issues/6429#issuecomment-2558265376) that further explains.
124
+
-**Blog**: The blog is not translated because it's not useful to translate blog posts. Most of the blog posts are release notes, and it's not useful to translate them.
125
+
-**Docs**: The API docs are too expansive, and versioned, to be translated.
0 commit comments