Skip to content

i18n(ko): add Korean translations 2026-05-04 - #5326

Merged
leaanthony merged 7 commits into
masterfrom
i18n/ko-2026-05-04
May 6, 2026
Merged

leaanthony merged 7 commits into
masterfrom
i18n/ko-2026-05-04

Conversation

@leaanthony

@leaanthony leaanthony commented May 4, 2026 •

Copy link
Copy Markdown
Member

Summary

Automated translation update for Korean (ko) documentation.

  • Files translated: 5
  • Translation model: qwen3.6:35b (Ollama)
  • Date: 2026-05-04

QA Scores

Metric Value
Average Score 0.980
Files Scored 5
Low Quality (< 0.75) None ✅

Generated by Wails Doc Translator agent (automated weekly i18n run — 2026-05-04)

Summary by CodeRabbit

  • Documentation
    • Added a complete Korean documentation suite: landing page with feature overview and banners, platform-specific installation and setup, quick-start guides (including next steps and "Why Wails"), and a roadmap/status page.
    • Updated translation cache metadata to record Korean documentation versions and updated timestamps.

Copilot AI review requested due to automatic review settings May 4, 2026 00:10
@coderabbitai

coderabbitai Bot commented May 4, 2026 •

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 10058dfd-5441-4e09-b5c8-395c3ebad647

📥 Commits

Reviewing files that changed from the base of the PR and between d3ed785 and e92f4ab.

📒 Files selected for processing (2)
  • docs/src/content/docs/ko/index.mdx
  • docs/src/content/docs/ko/quick-start/why-wails.mdx

Walkthrough

Adds Korean-language documentation and updates translation metadata: new Korean landing page, installation guide, quick-start pages (why-wails, next-steps), and a status/roadmap page; updates docs/.translation-cache/ko.json with per-file hashes and translated timestamps.

Changes

Korean Documentation Localization

Layer / File(s) Summary
Translation Metadata
docs/.translation-cache/ko.json
Adds per-file hash and translated_at entries for index.mdx, quick-start/why-wails.mdx, quick-start/next-steps.mdx, status.mdx, and getting-started/installation.mdx.
Landing Page Frontmatter & Assets
docs/src/content/docs/ko/index.mdx
Adds Astro frontmatter (title/description/banner), hero metadata (logos/actions/template) and imports for UI components.
Landing Page Content & Styling
docs/src/content/docs/ko/index.mdx
Adds hero section, OS-specific quick-start tabs (macOS/Windows/Linux), feature CardGrid, next-steps, sponsor card, and inline CSS (animated multi-row background, gradients, card blur/rounding, button styles, keyframes).
Installation Guide
docs/src/content/docs/ko/getting-started/installation.mdx
New Korean installation doc covering supported platforms, dependencies (Go ≥1.24, optional npm), CLI install (stable/dev), wails3 doctor, and troubleshooting PATH/terminal checks.
Quick Start — Why Wails
docs/src/content/docs/ko/quick-start/why-wails.mdx
New Korean page describing perceived performance, developer experience, production features, recommended use cases, architecture (Go backend + native WebView frontend), and links to next steps.
Quick Start — Next Steps
docs/src/content/docs/ko/quick-start/next-steps.mdx
New Korean page listing follow-up tutorials, a TODO app exercise, core feature references (windows, menus, dialogs, events, bindings, clipboard, DnD, keyboard), and community/help links.
Project Status / Roadmap
docs/src/content/docs/ko/status.mdx
New Korean roadmap/status page with alpha status, beta target, contribution guidance, and feedback/update policy.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • wailsapp/wails#5326: Modifies the same Korean MDX files and translation-cache entries — directly related.
  • wailsapp/wails#5328: Parallel i18n updates for a different locale (French) touching similar docs pages and translation-cache entries.
  • wailsapp/wails#5323: Parallel localized MDX additions and translation-cache updates for another locale (zh-CN) covering the same set of pages.

Poem

🐰 새 문서들이 폴짝 폴짝 왔네,
한글 길잡이로 길이 넓어졌네.
설치법·시작법·이유까지,
토끼가 속삭여요: 함께 빌드하자, 찰칵! 🥕✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The PR description provides a clear summary of the automated translation update, but lacks required template sections like explicit issue linking, type of change selection, testing details, and pre-submission checklist. Add 'Fixes #' reference, select appropriate change type checkbox, include testing platform checklist results, and complete verification checklist items.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: addition of Korean translations to the documentation dated 2026-05-04.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch i18n/ko-2026-05-04

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/src/content/docs/ko/getting-started/installation.mdx`:
- Around line 67-72: 문서의 설치 검증 명령어 표기가 일관되지 않습니다; 현재 텍스트의 "wails doctor" 인스턴스(예:
Linux 및 Windows 안내 문구에 있는 "wails doctor")를 프로젝트에서 통일하기로 한 표기인 "wails3 doctor"로
바꿔 문서 전체에서 명령어 표기를 일관되게 유지하세요.

In `@docs/src/content/docs/ko/index.mdx`:
- Around line 15-17: The hero "시작하기" CTA currently points to the wrong route
(the YAML entry with text: 시작하기 and link: /quick-start/installation); update
that link value to the correct installation doc path present in this PR (replace
the existing link: /quick-start/installation with the correct route) so the
landing page CTA routes users to the intended installation page.

In `@docs/src/content/docs/ko/quick-start/why-wails.mdx`:
- Around line 121-123: Update the broken CTA link in the markdown list item that
renders "1. **Wails 설치** - 5분 만에 개발 환경 설정" by changing the href currently set to
"/quick-start/installation" to the new path "/getting-started/installation" so
the "[설치 가이드 →]" link points to the added installation document (locate the link
text "[설치 가이드 →]" in the same list item and replace its URL).
- Line 109: 문장에 있는 모호한 표현 "하마초 단위 지연"을 명확한 한국어 기술 용어로 교정하세요; docs/content 문서의 해당
문장(이 간단한 아키텍처... 하마초 단위 지연)을 찾아 "하마초 단위 지연"을 "서브밀리초 지연" 또는 "밀리초 미만의 지연"으로 교체해
일관된 표현을 사용하고, 문맥상 자연스러운 표현으로 통일(추천: "서브밀리초 지연")하도록 수정하세요.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 71b934b2-553e-408e-a431-839670dd5b81

📥 Commits

Reviewing files that changed from the base of the PR and between 771fe1c and d903def.

📒 Files selected for processing (6)
  • docs/.translation-cache/ko.json
  • docs/src/content/docs/ko/getting-started/installation.mdx
  • docs/src/content/docs/ko/index.mdx
  • docs/src/content/docs/ko/quick-start/next-steps.mdx
  • docs/src/content/docs/ko/quick-start/why-wails.mdx
  • docs/src/content/docs/ko/status.mdx

Comment on lines +67 to +72
Wails는 [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. `wails doctor` 명령을 사용하여 확인할 수 있습니다.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux에는 표준 `gcc` 빌드 도구와 `gtk3`, `webkit2gtk`가 필요합니다. 설치 후 <code>wails doctor</code>를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.

@coderabbitai coderabbitai Bot May 4, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

v3 명령어 표기를 wails3 doctor로 통일하세요.

같은 문서의 Line 99는 wails3 doctor를 사용하고 있는데, Line 67/Line 72는 wails doctor로 되어 있어 설치 검증 단계에서 혼란/실행 실패를 유발할 수 있습니다.

Patch 제안
-    Wails는 [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. `wails doctor` 명령을 사용하여 확인할 수 있습니다.
+    Wails는 [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. `wails3 doctor` 명령을 사용하여 확인할 수 있습니다.
@@
-    Linux에는 표준 `gcc` 빌드 도구와 `gtk3`, `webkit2gtk`가 필요합니다. 설치 후 <code>wails doctor</code>를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.
+    Linux에는 표준 `gcc` 빌드 도구와 `gtk3`, `webkit2gtk`가 필요합니다. 설치 후 <code>wails3 doctor</code>를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/src/content/docs/ko/getting-started/installation.mdx` around lines 67 -
72, 문서의 설치 검증 명령어 표기가 일관되지 않습니다; 현재 텍스트의 "wails doctor" 인스턴스(예: Linux 및 Windows
안내 문구에 있는 "wails doctor")를 프로젝트에서 통일하기로 한 표기인 "wails3 doctor"로 바꿔 문서 전체에서 명령어
표기를 일관되게 유지하세요.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ℹ️ Source bug — wails doctor on lines 67/72 comes from the English source. The translation is accurate. Source needs fixing.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@leaanthony, thanks for the clarification — you're right, the translation is accurate and the issue lies in the English source file where wails doctor should be wails3 doctor. Apologies for the misdirected review comment.

Would you like me to open a GitHub issue to track updating the English source documentation (getting-started/installation.mdx) to use wails3 doctor consistently?

(ฅ•ω•ฅ)


✏️ Learnings added
Learnt from: leaanthony
Repo: wailsapp/wails PR: 5326
File: docs/src/content/docs/ko/getting-started/installation.mdx:67-72
Timestamp: 2026-05-04T12:19:38.974Z
Learning: In Wails v3 documentation, the correct CLI command is `wails3 doctor` (not `wails doctor`). The `wails3` prefix is used for all v3 CLI commands. When reviewing translated docs, if `wails doctor` appears it is likely a source bug in the English original, not a translation error.

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.


🧠 Learnings used
Learnt from: popaprozac
Repo: wailsapp/wails PR: 4839
File: docs/src/content/docs/reference/window.mdx:616-620
Timestamp: 2025-12-29T08:02:06.122Z
Learning: In Wails v3, document window creation using app.Window.New() and app.Window.NewWithOptions(...). Do not show or reference app.NewWebviewWindow() or app.NewWebviewWindowWithOptions(...). The Application struct exposes a Window field of type *WindowManager that provides these methods. When updating docs, replace examples accordingly and mention that WindowManager methods create and configure new windows.

Comment thread docs/src/content/docs/ko/index.mdx
Comment thread docs/src/content/docs/ko/quick-start/why-wails.mdx Outdated
Comment thread docs/src/content/docs/ko/quick-start/why-wails.mdx

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR adds a first batch of Korean-language documentation pages for the v3 docs site, covering the homepage, onboarding pages, status page, and a translation cache entry. It extends the existing docs content structure with localized copies of key entry-point pages.

Changes:

  • Add Korean translations for the docs homepage and several onboarding/status pages.
  • Introduce a Korean installation page plus localized quick-start content.
  • Update the Korean translation cache metadata for the translated files.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
docs/src/content/docs/ko/status.mdx Adds Korean translation of the project status/roadmap page.
docs/src/content/docs/ko/quick-start/why-wails.mdx Adds Korean translation of the “Why Wails?” quick-start page.
docs/src/content/docs/ko/quick-start/next-steps.mdx Adds Korean translation of the quick-start next-steps page.
docs/src/content/docs/ko/index.mdx Adds a Korean version of the docs landing page.
docs/src/content/docs/ko/getting-started/installation.mdx Adds a Korean installation/setup page under the getting-started section.
docs/.translation-cache/ko.json Records translation hashes and timestamps for the Korean docs batch.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/src/content/docs/ko/index.mdx Outdated
Comment on lines +16 to +20
link: /quick-start/installation
icon: right-arrow
variant: primary
- text: 튜토리얼 보기
link: /tutorials/03-notes-vanilla

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

✅ Fixed — Hero CTA updated to /ko/getting-started/installation.

[첫 번째 앱 튜토리얼 →](/quick-start/first-app)

3. **기능 탐색** - Wails가 애플리케이션에 어떤 기능을 제공할 수 있는지 발견
[기능 개요 →](/quick-start/next-steps)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

✅ Fixed — next-steps link in why-wails.mdx now points to /ko/quick-start/next-steps.


## 현재 상태: 알파

최신 현황은 [변경 사항](./changelog) 페이지에서 확인하세요.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ℹ️ Known limitation — ko/changelog.mdx not in this batch.

</div>
</div>

이 간단한 아키텍처를 통해 JavaScript 코드는 자동 생성된 바인딩을 통해 Go 함수를 직접 호출할 수 있으며, Go는 이벤트와 데이터를 프론트엔드로 보낼 수 있습니다. 두 레이어는 하마초 단위 지연 시간을 가진 효율적인 인메모리 브릿지를 통해 통신합니다.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

✅ Fixed — 하마초 corrected to 밀리초.

@@ -0,0 +1,106 @@
---
title: 설치
description: Wails 설치 및 개발 환경 설정

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

🔄 Structural — File placement mirrors source structure. Navigation alignment will come with locale registration.

Wails를 설치하기 전에 여러 공통 의존성이 필요합니다:

<Tabs>
<TabItem label="Go (최소 1.24)" icon="seti:go">

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ℹ️ Source bug — English source says Go (At least 1.24).

Comment on lines +67 to +72
Wails는 [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. `wails doctor` 명령을 사용하여 확인할 수 있습니다.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux에는 표준 `gcc` 빌드 도구와 `gtk3`, `webkit2gtk`가 필요합니다. 설치 후 <code>wails doctor</code>를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ℹ️ Source bug — wails doctor from English source lines 68/73.

Comment on lines +67 to +72
Wails는 [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)이 설치되어 있어야 합니다. 대부분의 Windows 설치에는 이미 이 런타임이 설치되어 있습니다. `wails doctor` 명령을 사용하여 확인할 수 있습니다.

</TabItem>
<TabItem label="Linux" icon="linux">

Linux에는 표준 `gcc` 빌드 도구와 `gtk3`, `webkit2gtk`가 필요합니다. 설치 후 <code>wails doctor</code>를 실행하여 의존성 설치 방법을 확인하세요. 배포판이나 패키지 관리자가 지원되지 않는 경우 Discord에서 알려주세요.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

ℹ️ Source bug — Same as above — wails doctor from the English source.

@leaanthony
leaanthony merged commit 30fa00b into master May 6, 2026
11 of 15 checks passed
@leaanthony
leaanthony deleted the i18n/ko-2026-05-04 branch May 6, 2026 12:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants