Skip to content

Add Korean translations for all documentation#142

Merged
em3s merged 14 commits intomainfrom
docs/i18n-by-kanana
Jan 28, 2026
Merged

Add Korean translations for all documentation#142
em3s merged 14 commits intomainfrom
docs/i18n-by-kanana

Conversation

@eazyhozy
Copy link
Copy Markdown
Member

Summary

Add Korean translations for all English documentation using Kakao's internal Kanana-2 API.

This PR translates the entire documentation site to Korean, leveraging Kakao's internal infrastructure that provides the Kanana-2 translation API.

Changes

  • Add Korean translations for 35 documentation files:
    • api-references/ (4 files): index, metadata, mutation, query
    • community/ (5 files): contributing, development, governance, releases, roadmap
    • design/ (6 files): concepts, glossary, mutation, query, schema, storage-backends
    • guides/ (3 files): commerce app, social gifting app, social media app
    • internals/ (1 file): encoding
    • operations/ (3 files): benchmarks, cli, hbase
    • project/ (2 files): about-kakao, path-to-open-source
    • provisioning/ (1 file): kubernetes
    • stories/ (5 files): kakaotalk-friends, gift-recent-views, gift-wish, pipeline, unified-graph
    • Root level (5 files): faq, for-rdb-users, introduction, llms-txt, quick-start

How to Test

  1. Run the development server: cd website && npm run dev
  2. Navigate to any documentation page
  3. Switch language to Korean using the language selector
  4. Verify translations are displayed correctly

Translate English documentation to Korean using Kanana-2 API.

Translated files:
- api-references (4 files)
- community (5 files)
- design (6 files)
- guides (3 files)
- internals (1 file)
- operations (3 files)
- project (2 files)
- provisioning (1 file)
- stories (5 files)
- Root level docs (5 files)
@eazyhozy eazyhozy requested a review from em3s as a code owner January 27, 2026 23:04
@dosubot dosubot bot added size:XXL This PR changes 1000+ lines, ignoring generated files. documentation Improvements or additions to documentation labels Jan 27, 2026
@eazyhozy eazyhozy self-assigned this Jan 27, 2026
eazyhozy and others added 13 commits January 28, 2026 08:32
- Add remark-custom-heading-id plugin for custom heading IDs
- Add explicit heading IDs to Korean docs matching English anchors
- Add /ko/ prefix to internal links for proper locale routing
- Fix import statement in build-your-social-media-app.mdx
- Add Banner component showing Kanana-2 translation notice on /ko pages
- Add i18n glossary and translation prompt files
- Removed `index.mdx`, `metadata.mdx`, and `mutation.mdx` under `docs/ko/api-references` as they are no longer relevant.
- Add translated-by-kanana-2: true to 20 Korean translated docs
- Modify Footer.astro to show translation notice only for flagged docs
Remove escaped bold markers and fix broken table syntax in Korean docs.
Update story titles to more natural Korean expressions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add custom frontmatter field to docsSchema for translation notice
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@em3s
Copy link
Copy Markdown
Contributor

em3s commented Jan 28, 2026

LGTM 👍 Great Work!

@em3s em3s merged commit b1b6781 into main Jan 28, 2026
10 checks passed
@eazyhozy
Copy link
Copy Markdown
Member Author

Translation automation workflow setup, glossary and prompt improvements will be addressed in follow-up work.

@em3s em3s changed the title docs(i18n): add Korean translations for all documentation Add Korean translations for all documentation Feb 12, 2026
@eazyhozy eazyhozy deleted the docs/i18n-by-kanana branch February 24, 2026 04:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants