Skip to content

Conversation

@rakesh2OO5
Copy link

@rakesh2OO5 rakesh2OO5 commented Jan 13, 2026

Summary
Fixes missing and inconsistent translations for Example Categories across multiple languages.

What was changed

  • Added consistent example category keys
  • Fixed capitalization and key mismatches
  • Translated missing category headings (e.g. Parallel Loading Promise)
  • Updated the following locales:
    • English
    • Spanish
    • Hindi
    • Korean
    • Chinese (Simplified)

Verification

  • Manually verified /examples pages in all supported languages
  • Confirmed category headings render correctly

fixes issue #283

@rakesh2OO5
Copy link
Author

rakesh2OO5 commented Jan 13, 2026

I have tested the sanity of the fix locally , i will be attaching all the required proofs down here :
chinese
english
hindi
korean
spanish

@rakesh2OO5
Copy link
Author

Hi @limzykenneth 👋
Just a gentle follow-up on this PR when you get a chance.
It’s been open for about two weeks, and I’m happy to make any changes or address feedback if needed.
Thanks for your time and for maintaining the project! 🙏

@limzykenneth
Copy link
Member

Some questions. What is the source of the translation? Especially for the updates? What is your understanding of the original issue?

@rakesh2OO5
Copy link
Author

rakesh2OO5 commented Jan 25, 2026

Hi @limzykenneth, thanks for taking a look and for the questions — happy to clarify!

Source of the translations :
For Spanish, Hindi, Korean, and Simplified Chinese, I used a combination of:
Existing terminology already used elsewhere in this repo (to keep phrasing consistent across the site), and
Native-language references and community-accepted translations for technical UI terms (e.g. “Parallel Loading Promise”, “Advanced Canvas Rendering”, “Listing Data with Arrays”).
My main goal was consistency over literal translation, so category labels match the tone and style of the rest of each locale’s UI rather than being direct word-for-word conversions.

About the updates
The changes focus on:
Filling in missing exampleCategories keys that were present in en.yaml but absent or inconsistent in other locales
Fixing capitalization/key mismatches that could prevent proper rendering
Adding a translated label for “Parallel Loading Promise” so it appears uniformly across all supported languages

My understanding of the original issue (#283)
The core problem was that the Examples page showed missing or inconsistent category headings across languages, which caused:
Some categories not rendering at all in non-English locales
Mismatched labels due to key differences rather than content issues
This PR aims to standardize the keys across all locale files and ensure each language has a complete and consistent set of category labels.

If you’d prefer a different translation style or have a recommended source/guide for localization in this project, I’d be very happy to align with it and update the PR accordingly. Thanks again for your time and guidance!

@limzykenneth
Copy link
Member

The reason I'm asking is that there are many translation changes that are not missing originally but they are changed, which is not what the original issue is about. Some of these translation changes also does not make sense since they don't change the meaning at all. I'm also not happy to accept any machine translation without native language user's input.

@rakesh2OO5
Copy link
Author

Hi @limzykenneth, thank you for clarifying — I appreciate you pointing this out.

You’re absolutely right about the scope. My intent was to ensure consistency across locales, but I understand now that this went beyond the original goal of addressing missing category keys only.

I can revise this PR to:
-Revert any translation changes that were not strictly missing or broken
-Keep only additions required to make the categories render correctly
-Limit the diff to structural/key completeness rather than wording changes

For the translated labels I added, I agree that native-language validation is important. If you’d prefer, I can either remove those or flag them for review by native contributors instead of including them here.

Please let me know which direction you’d prefer, and I’ll update the PR accordingly. Thanks for taking the time to review and guide me on this .

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