Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: document what we want/wan't translate #7350

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

AugustinMauroy
Copy link
Member

@AugustinMauroy AugustinMauroy commented Dec 22, 2024

Description

People often ask why the learn section isn't translated, so I've written a bit of a document about it. But I'm not very good at the documentation part. So if anyone knows how to go over my work again, I think it would be beneficial.

The first review should be done by the website team and why not have it validated by the TSC?

Check List

  • I have read the Contributing Guidelines and made commit messages that follow the guideline.
  • I have run npm run format to ensure the code follows the style guide.

@Copilot Copilot bot review requested due to automatic review settings December 22, 2024 15:21
@AugustinMauroy AugustinMauroy requested a review from a team as a code owner December 22, 2024 15:21
Copy link

vercel bot commented Dec 22, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
nodejs-org ✅ Ready (Inspect) Visit Preview Dec 23, 2024 10:09pm

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comments suppressed due to low confidence (1)

TRANSLATION.md:100

  • The heading 'Why We Translate This section and Not this Section' should be 'Why We Translate This Section and Not This Section' for consistent capitalization.
## Why We Translate This section and Not this Section

TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
Co-authored-by: Copilot <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>
Copy link
Collaborator

@bmuenzenmeyer bmuenzenmeyer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for putting this together.

i thought afterwards that this could also be a markdown table, but this is fine

TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Show resolved Hide resolved
TRANSLATION.md Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated
Comment on lines 122 to 123
- **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.
- **Learn**: The learn section is not translated because it contains technical terms that are hard to translate. Plus, we don't have the ability to trust the quality of the translations. 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 summarizes whole reasons.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add that this is a TSC decision

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know that but idk how to write down that

TRANSLATION.md Outdated Show resolved Hide resolved
TRANSLATION.md Outdated Show resolved Hide resolved
Co-authored-by: Brian Muenzenmeyer <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants