[DOCS, FIX] ko translation - phase 3, fix termynal.js comments render

Author: bnbong

docs/en/contributing/translation-guide.md

@@ -18,6 +18,12 @@ The user-facing companion to this policy is the
 lists each locale's actual completeness and how MkDocs renders pages
 that haven't been translated yet (TL;DR: they fall back to English).
 
+The repository-root `CHANGELOG.md` also remains in English as the
+canonical release history. If a locale exposes a `changelog.md` page,
+that page should link to or include the canonical English changelog
+rather than maintain a separate translated changelog unless project
+policy changes later.
+
 When you contribute a translation, also update the status page's table
 so users can tell what's available without guessing from the language
 switcher.
@@ -213,6 +219,14 @@ The script will create a Pull Request with the translations. Review the PR:
 3. Ensure code examples remain unchanged
 4. Check for language-specific issues
 
+### Changelog policy
+
+- Keep the repository-root `CHANGELOG.md` in English.
+- Do not open translation PRs whose goal is to rewrite release history
+  into another language inside the root changelog.
+- If a locale needs a changelog page, treat `docs/<locale>/changelog.md`
+  as a wrapper or entry point for the canonical English changelog.
+
 ### 4. Approve and Merge (for maintainers)
 
 Once the translation is verified:

docs/en/reference/translation-status.md

@@ -19,6 +19,11 @@ The English files live under [`docs/en/`](https://github.com/bnbong/FastAPI-fast
 Every other locale (`docs/ko/`, `docs/ja/`, ...) is a translation
 target.
 
+The repository-root `CHANGELOG.md` is part of that English source of
+truth. Locale-specific `changelog.md` pages may exist as wrappers or
+entry points, but they intentionally reuse the canonical English
+release history instead of maintaining translated copies.
+
 ## Per-locale completeness
 
 The numbers below count Markdown pages in each locale's directory tree
@@ -29,14 +34,14 @@ next section explains).
 | Locale | Status | Markdown pages | Notes |
 |---|---|---:|---|
 | 🇬🇧 English (`en`) | ✅ Source of truth | 26 / 26 | Authoritative. |
-| 🇰🇷 Korean (`ko`) | 🟡 Partial | 19 / 26 | `index.md`, `changelog.md`, `reference/translation-status.md`, all 7 user-guide pages, and all 9 tutorial pages. Other pages (contributing, broader reference) fall back to English. |
+| 🇰🇷 Korean (`ko`) | ✅ Complete | 26 / 26 | All locale pages are present. Phase 1: top-level + core user-guide; Phase 2: remaining user-guide + all tutorials; Phase 3: contributing + reference. `docs/ko/changelog.md` intentionally reuses the canonical English `CHANGELOG.md`. |
 | 🇯🇵 Japanese (`ja`) | 🔴 Skeleton | 0 / 26 | Build target only. Every page falls back to English. |
 | 🇨🇳 Chinese (`zh`) | 🔴 Skeleton | 0 / 26 | Build target only. Every page falls back to English. |
 | 🇪🇸 Spanish (`es`) | 🔴 Skeleton | 0 / 26 | Build target only. Every page falls back to English. |
 | 🇫🇷 French (`fr`) | 🔴 Skeleton | 0 / 26 | Build target only. Every page falls back to English. |
 | 🇩🇪 German (`de`) | 🔴 Skeleton | 0 / 26 | Build target only. Every page falls back to English. |
 
-*Snapshot verified 2026-05-07; ko row recounted for the current branch after Phase 2 (user-guide + tutorial) translations landed.* These counts are maintained by hand;
+*Snapshot verified 2026-05-07; ko row recounted for the current branch after Phase 3 (contributing + reference) landed. Korean now has all locale pages present, while `docs/ko/changelog.md` intentionally points to the canonical English changelog.* These counts are maintained by hand;
 to recount the current state from the repo root, run:
 
 ```console
@@ -91,9 +96,9 @@ underlying content actually is.
 The current rollout is **one tracking issue per locale**, with the work
 broken into **phases** — for example `ko` is being landed across
 Phase 1 (top-level + core user-guide), Phase 2 (remaining user-guide +
-all tutorials), Phase 3 (contributing + reference + changelog). Each
-phase ships as its own PR so reviewers can sign off on a coherent slice
-without waiting for the entire locale to be finished.
+all tutorials), Phase 3 (contributing + reference). Each phase ships
+as its own PR so reviewers can sign off on a coherent slice without
+waiting for the entire locale to be finished.
 
 If you'd like to contribute:
 
@@ -113,7 +118,9 @@ If you'd like to contribute:
 4. Open the PR adding files under `docs/<locale>/<same path>`. Keep
    filenames identical to the English source so MkDocs picks them up
    automatically.
-5. Update this page's table to reflect the new completeness count
+5. Treat localized changelog pages as wrappers around the canonical
+   English `CHANGELOG.md` unless project policy explicitly changes.
+6. Update this page's table to reflect the new completeness count
    (use the recount snippet at the top of this page) and bump the
    "Snapshot verified" date so reviewers can see when it was last
    reconciled. Note in the "Notes" column which phase has landed if

docs/js/custom.js

@@ -67,15 +67,23 @@ function setupTermynal() {
                         saveBuffer();
                         const promptStart = line.indexOf(promptLiteralStart);
                         if (promptStart === -1) {
-                            console.error("Custom prompt found but no end delimiter", line)
+                            const value = "💬 " + line.replace(customPromptLiteralStart, "").trimEnd();
+                            useLines.push({
+                                value: value,
+                                class: "termynal-comment",
+                                delay: 0
+                            });
+                        } else {
+                            const prompt = line
+                                .slice(0, promptStart)
+                                .replace(customPromptLiteralStart, "");
+                            const value = line.slice(promptStart + promptLiteralStart.length);
+                            useLines.push({
+                                type: "input",
+                                value: value,
+                                prompt: prompt
+                            });
                         }
-                        const prompt = line.slice(0, promptStart).replace(customPromptLiteralStart, "")
-                        let value = line.slice(promptStart + promptLiteralStart.length);
-                        useLines.push({
-                            type: "input",
-                            value: value,
-                            prompt: prompt
-                        });
                     } else {
                         buffer.push(line);
                     }