@intlayer/docs 6.0.1 → 6.0.2

package/docs/ko/releases/v6.md

@@ -0,0 +1,273 @@
+---
+createdAt: 2025-09-22
+updatedAt: 2025-09-22
+title: New Intlayer v6 - 새로운 기능은 무엇인가요?
+description: Intlayer v6의 새로운 기능을 알아보세요. 성능, 개발자 경험, 그리고 국제화 워크플로우를 향상시키는 주요 기능들이 포함되어 있습니다.
+keywords:
+  - Intlayer
+  - 현지화
+  - 개발
+  - 성능
+  - 개발자 경험
+  - 기능
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - releases
+  - v6
+---
+
+# New Intlayer v6 - 새로운 기능은 무엇인가요?
+
+Intlayer v6에 오신 것을 환영합니다! 이번 릴리스는 성능, 개발자 경험, 그리고 안정성에 중점을 두고 있습니다. 아래는 주요 내용과 마이그레이션 노트, 복사하여 붙여넣을 수 있는 예제들입니다.
+
+## 주요 내용
+
+- 누락된 번역을 감지하는 새로운 명령어: `npx intlayer content test`
+- 누락된 번역을 자동 생성하는 새로운 전역 `autoFill` 옵션
+- Fill 명령어는 기본적으로 기존 번역을 건너뜁니다: `npx intlayer fill`
+- VS Code 확장: 새로운 Intlayer 활동 표시줄(검색 및 사전), 툴바/컨텍스트 액션, 자동 표시, Fill/Test 명령어
+- 프로미스 병렬 처리로 10배 빠른 빌드 속도
+- 앱 시작 시 재요청을 방지하는 원격 사전 캐싱
+- 향상된 로깅: 동작을 검사하려면 `log.mode: 'verbose'` 설정
+- 사전 문제로 인한 앱 충돌 방지를 위한 강화된 검증
+- `build.importMode = 'live'` 및 `pnpm intlayer live`를 사용한 CMS 실시간 업데이트
+- 수정 사항: Vue.js 통합, Lynx 어댑터, Windows용 비주얼 에디터
+
+---
+
+## 새로운 기능: 누락된 번역 테스트
+
+프로젝트를 빠르게 감사하여 누락된 키/로케일을 찾습니다.
+
+```bash
+npx intlayer content test
+```
+
+출력:
+
+```bash
+pnpm intlayer content test
+누락된 번역:
+ - blog-data       - 일본어 (ja), 한국어 (ko), 중국어 (zh), 독일어 (de), 이탈리아어 (it) - src/components/BlogPage/blogData.content.ts
+ - demo-page       - 프랑스어 (fr), 이탈리아어 (it)                                         - src/components/DemoPage/demo.content.ts
+ - locale-switcher - 이탈리아어 (it), 포르투갈어 (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.ts
+로케일: 영어 (en), 러시아어 (ru), 일본어 (ja), 프랑스어 (fr), 한국어 (ko), 중국어 (zh), 스페인어 (es), 독일어 (de), 아랍어 (ar), 이탈리아어 (it), 영국 영어 (en-GB), 포르투갈어 (pt), 힌디어 (hi)
+필수 로케일: 영어 (en)
+누락된 로케일: 일본어 (ja), 한국어 (ko), 중국어 (zh), 독일어 (de), 이탈리아어 (it), 프랑스어 (fr), 포르투갈어 (pt)
+필수 누락 로케일: -
+총 누락 로케일 수: 7
+총 필수 누락 로케일 수: 0
+```
+
+CLI 문서에서 더 많은 옵션을 확인하세요: [CLI 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md) → "누락된 번역 테스트". 또한 [테스팅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/testing.md) 가이드를 참고하세요.
+
+---
+
+## 새 기능: 누락된 번역을 완성하는 글로벌 autoFill
+
+이제 전역적으로 auto-fill을 활성화하여 누락된 번역이 있는 모든 사전을 자동으로 완성할 수 있습니다.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  content: {
+    // 모든 사전의 누락된 번역을 자동 생성합니다
+    autoFill: "./{{fileName}}.content.ts",
+    //
+    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // autoFill: true, // "./{{fileName}}.content.json"을 사용하는 것처럼 모든 사전에 대해 누락된 번역을 자동 생성합니다
+    //
+    // autoFill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+콘텐츠 파일 내 `autoFill` 필드를 사용하여 사전별로 세부 조정을 계속할 수 있습니다. 전체 참조는 `doc/autoFill` 및 `doc/dictionary/content_file`에서 확인하세요.
+
+---
+
+## fill 명령어: 더 안전한 기본값
+
+fill 명령어는 이제 기본적으로 누락된 번역만 채우고 기존 콘텐츠는 건너뜁니다.
+
+```bash
+npx intlayer fill
+```
+
+```bash
+처리할 사전 키: access-key-creation-form-schema, doc-search-metadata, doc-search-page
+  - [access-key-creation-form-schema]      사전에 파일 경로가 없습니다. 건너뜁니다.
+  - [access-key-creation-form-schema]      콘텐츠 선언 처리 중: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
+  - [access-key-creation-form-schema]      채울 로케일이 없습니다 - 사전 건너뜁니다
+  - [doc-search-metadata]                  사전 파일 경로가 없습니다. 건너뜁니다.
+  - [doc-search-metadata]                  콘텐츠 선언 처리 중: src/app/[locale]/(docs)/doc/search/metadata.content.ts
+  - [doc-search-metadata]                  채울 로케일이 없습니다 - 사전 건너뜁니다.
+  - [doc-search-page]                      사전 파일 경로가 없습니다. 건너뜁니다.
+  - [doc-search-page]                      콘텐츠 선언 처리 중: src/app/[locale]/(docs)/doc/search/page.content.ts
+  - [doc-search-page]                     [러시아어 (ru)]                   영어(en)에서 러시아어(ru)로 사전 번역 준비 중
+[intlayer]  src/app/[locale]/(docs)/doc/search/page.content.ts에 Prettier 포맷팅 적용 완료
+  - [doc-search-page]                      Content declaration written to src/app/[locale]/(docs)/doc/search/page.content.ts
+```
+
+CI 예제는 [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/CI_CD.md)에서 확인할 수 있습니다.
+
+---
+
+## 업데이트된 VS Code 확장 기능
+
+이 확장 기능은 이제 Activity Bar에 전용 Intlayer 탭을 포함하며 여러 워크플로우 개선 사항이 적용되었습니다:
+
+- 두 가지 뷰가 있는 Intlayer Activity Bar:
+  - 라이브 사전/콘텐츠 검색을 위한 검색 웹뷰 (`intlayer.searchBar`)
+  - 환경, 사전, 기여 파일을 나열하는 사전 트리 (`intlayer.dictionaries`)
+- 사전 뷰의 툴바: 빌드, 풀, 푸시, 채우기, 새로 고침, 테스트, 사전 파일 생성
+- 컨텍스트 메뉴: 사전에서 풀/푸시; 파일에서 채우기
+- 자동 표시: 현재 편집기 파일이 해당되는 경우 사전 트리에서 강조 표시됩니다.
+- 명령 팔레트에서 사용할 수 있는 새로운 명령: 사전 채우기(Fill Dictionaries) 및 사전 테스트(Test Dictionaries)
+
+자세한 내용은 [공식 VS Code 확장](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md) 문서를 참조하세요.
+
+---
+
+## 성능: 10배 빠름
+
+- 로컬 및 원격 사전의 병렬 해석
+- 원격 사전은 앱 시작 시 재요청을 방지하기 위해 캐시됨
+
+```bash
+npx intlayer build
+```
+
+출력:
+
+```bash
+[intlayer]  Intlayer 준비 중 (v6.0.1)
+[intlayer]  사전:
+[intlayer]  ✓ 로컬 콘텐츠: 163/163
+[intlayer]  ✓ 원격 콘텐츠: 100/100
+[intlayer]   - access-key-creation-form             [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - access-key-creation-form-schema      [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - access-key-form                      [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - ai-ab-testing-section                                 [distant: ✔ 가져옴]
+[intlayer]   - application-not-running-view         [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - application-template-message         [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - aside-navigation                     [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - ask-reset-password                   [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - ask-reset-password-schema            [local: ✔ 빌드됨] [distant: ✔ 가져옴]
+[intlayer]   - 자동완성-섹션               [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
+[intlayer]   - 사용가능-기술-섹션             [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
+[intlayer]   - 블로그-데이터                            [로컬: ✔ 빌드됨]
+[intlayer]   - 블로그-메타데이터                        [로컬: ✔ 빌드됨]
+[intlayer]   - 블로그-네비게이션-리스트                        [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
+[intlayer]   - 블로그-페이지                                             [원격: ✔ 가져옴]
+[intlayer]   - 블로그-검색-메타데이터                 [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
+[intlayer]   - 블로그-검색-페이지                     [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
+...
+[intlayer]  콘텐츠 로드 완료  (총: 8401ms - 로컬: 4050ms - 원격: 4222ms)
+```
+
+---
+
+## 로깅 개선사항
+
+빌드 및 런타임 변환 중에 발생하는 상황에 대해 더 자세한 정보를 제공하도록 로깅 시스템이 개선되었습니다.
+
+> 빌드 및 런타임 변환 중에 발생하는 상황을 더 잘 이해하려면 자세한 로그를 활성화하세요.
+
+```ts fileName="intlayer.config.ts"
+export default {
+  log: {
+    mode: "verbose", // 옵션: "default" | "verbose" | "disabled"
+  },
+};
+```
+
+모든 로깅 옵션은 [설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 확인하세요.
+
+---
+
+## 강화된 검증
+
+사전 처리 시 더 강력한 검증이 수행됩니다. 사전 처리에 실패할 경우, Intlayer는 애플리케이션이 중단되지 않도록 하며, 실행 가능한 오류를 표시합니다.
+
+---
+
+## CMS와 함께하는 라이브 업데이트 (프로덕션 안전)
+
+프로덕션 환경에서 애플리케이션을 다시 빌드하지 않고 라이브 콘텐츠 업데이트(예: 편집 업데이트)를 제공합니다.
+
+1. 라이브 임포트 모드를 활성화하세요:
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  build: {
+    importMode: "live", // "static" | "dynamic" | "live"
+  },
+  editor: {
+    liveSync: true, // 서버 측 라이브 동기화 활성화
+  },
+};
+
+export default config;
+```
+
+2. 앱을 실행하고 라이브 프로세스를 병행하세요:
+
+```bash
+npx intlayer live --process 'vite preview'
+```
+
+참고:
+
+- 라이브 모드 사용으로 표시된 사전만 라이브로 가져옵니다. 나머지는 성능 최적화를 위해 처리됩니다.
+- 라이브 API에 접근할 수 없으면 동적 임포트로 대체됩니다.
+
+[CMS 및 라이브 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)와 [구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)을 참조하여 완전한 안내를 확인하세요.
+
+---
+
+## 마이그레이션 노트
+
+- 제거됨: `dictionaryOutput` (이전에는 `i18next` 또는 `next-intl`). 향후 버전에서 플러그형 어댑터로 다시 제공될 예정입니다. 구성에서 해당 필드를 제거하세요.
+- 관련 제거: `i18nextResourcesDir` (`doc/configuration` 변경 로그 참조).
+- 대규모 누락 번역 생성을 위해 새로운 전역 옵션 `content.autoFill` 사용을 권장합니다.
+- 누락된 번역에 대해 PR을 검증하려면 `npx intlayer content test`를 사용하세요.
+- 자세한 진단을 위해 `log.mode = 'verbose'`로 설정하세요.
+
+---
+
+## 수정 사항
+
+- Vue.js 통합 안정성 향상
+- Lynx 어댑터 개선
+- Windows에서의 비주얼 에디터
+
+---
+
+## 유용한 링크
+
+- [CLI 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md)
+- [자동 채우기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/autoFill.md)
+- [구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)
+- [콘텐츠 파일 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)
+- [공식 VS 코드 확장](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md)
+- [CMS 및 라이브 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)

package/docs/ko/roadmap.md

@@ -112,18 +112,16 @@ enu 함수를 사용하여 숫자 값, 범위 또는 사용자 정의 키에 따
 Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON**을 지원합니다.
 
 - **TypeScript**:
-
   - 콘텐츠 구조가 올바르고 누락된 번역이 없도록 보장합니다.
   - 엄격하거나 더 유연한 검증 모드를 제공합니다.
   - 변수, 함수 또는 외부 API에서 동적으로 데이터를 가져올 수 있습니다.
 
 - **JSON**:
-
   - 표준화된 형식 덕분에 외부 도구(예: 시각적 편집기)와 쉽게 통합할 수 있습니다.
 
   > 참고 자료:
   >
-  > - [콘텐츠 선언 형식](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_extention_customization.md)
+  > - [콘텐츠 선언 형식](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)
 
 ### 7. 정리, 번들 최적화 및 동적 임포트
 

package/docs/ko/vs_code_extension.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-03-17
-updatedAt: 2025-06-29
+updatedAt: 2025-09-22
 title: 공식 VS 코드 확장
-description: VS 코드에서 Intlayer 확장을 사용하여 개발 워크플로우를 향상시키는 방법을 알아보세요. 현지화된 콘텐츠 간 빠른 탐색과 사전 관리를 효율적으로 수행할 수 있습니다.
+description: VS 코드에서 Intlayer 확장을 사용하여 개발 워크플로를 향상시키는 방법을 알아보세요. 현지화된 콘텐츠 간을 빠르게 탐색하고 사전을 효율적으로 관리할 수 있습니다.
 keywords:
   - VS 코드 확장
   - Intlayer
@@ -31,27 +31,75 @@ slugs:
 
 ### 즉시 탐색
 
-**정의로 이동 지원** – `useIntlayer` 키에서 `Cmd+클릭`(Mac) 또는 `Ctrl+클릭`(Windows/Linux)을 사용하여 해당 콘텐츠 파일을 즉시 엽니다.  
+**정의로 이동 지원** – `useIntlayer` 키에서 `⌘ + 클릭`(Mac) 또는 `Ctrl + 클릭`(Windows/Linux)을 사용하여 해당 콘텐츠 파일을 즉시 엽니다.  
 **원활한 통합** – **react-intlayer** 및 **next-intlayer** 프로젝트와 문제없이 작동합니다.  
 **다국어 지원** – 다양한 언어의 현지화된 콘텐츠를 지원합니다.  
-**VS Code 통합** – VS Code의 탐색 및 명령 팔레트와 원활하게 통합됩니다.
+**VS 코드 통합** – VS 코드의 탐색 및 명령 팔레트와 원활하게 통합됩니다.
 
 ### 사전 관리 명령어
 
-VS Code에서 직접 콘텐츠 사전을 관리하세요:
+VS 코드에서 직접 콘텐츠 사전을 관리하세요:
 
-- **사전 빌드** (`extension.buildDictionaries`) – 프로젝트 구조에 따라 콘텐츠 파일을 생성합니다.
-- **사전 푸시** (`extension.pushDictionaries`) – 최신 사전 콘텐츠를 저장소에 업로드합니다.
-- **사전 풀** (`extension.pullDictionaries`) – 저장소에서 최신 사전 콘텐츠를 로컬 환경과 동기화합니다.
+- **사전 빌드** – 프로젝트 구조를 기반으로 콘텐츠 파일을 생성합니다.
+- **사전 푸시** – 최신 사전 콘텐츠를 저장소에 업로드합니다.
+- **사전 풀** – 저장소에서 최신 사전 콘텐츠를 로컬 환경으로 동기화합니다.
+- **사전 채우기** – 프로젝트의 콘텐츠로 사전을 채웁니다.
+- **사전 테스트** – 누락되었거나 불완전한 번역을 식별합니다.
 
 ### 콘텐츠 선언 생성기
 
 다양한 형식으로 구조화된 사전 파일을 쉽게 생성할 수 있습니다:
 
-- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
-- **ES 모듈 (`.esm`)** – `extension.createDictionaryFile.esm`
-- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
-- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+현재 컴포넌트 작업 중이라면 `.content.{ts,tsx,js,jsx,mjs,cjs,json}` 파일을 자동으로 생성합니다.
+
+컴포넌트 예시:
+
+```tsx fileName="src/components/MyComponent/index.tsx"
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("my-component");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+TypeScript 형식으로 생성된 파일:
+
+```tsx fileName="src/components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "my-component",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+사용 가능한 형식:
+
+- **TypeScript (`.ts`)**
+- **ES 모듈 (`.esm`)**
+- **CommonJS (`.cjs`)**
+- **JSON (`.json`)**
+
+### Intlayer 탭 (활동 표시줄)
+
+VS Code 활동 표시줄에서 Intlayer 아이콘을 클릭하여 Intlayer 탭을 엽니다. 이 탭에는 두 가지 뷰가 포함되어 있습니다:
+
+- **검색(Search)**: 사전과 그 내용을 빠르게 필터링할 수 있는 실시간 검색 바입니다. 입력할 때마다 결과가 즉시 업데이트됩니다.
+- **사전(Dictionaries)**: 환경/프로젝트, 사전 키, 그리고 항목을 기여하는 파일들의 트리 뷰입니다. 다음 작업을 할 수 있습니다:
+  - 파일을 클릭하여 편집기에서 엽니다.
+  - 툴바를 사용하여 다음 작업을 실행합니다: 빌드(Build), 풀(Pull), 푸시(Push), 채우기(Fill), 새로고침(Refresh), 테스트(Test), 사전 파일 생성(Create Dictionary File).
+  - 항목별 작업을 위한 컨텍스트 메뉴를 사용합니다:
+    - 사전에서는: 풀(Pull) 또는 푸시(Push)
+    - 파일에서는: 사전 채우기(Fill Dictionary)
+  - 편집기를 전환할 때, 해당 파일이 사전에 속해 있으면 트리가 일치하는 파일을 표시합니다.
 
 ## 설치
 
@@ -62,28 +110,30 @@ VS Code에서 직접 콘텐츠 사전을 관리하세요:
 3. **"Intlayer"**를 검색합니다.
 4. **설치**를 클릭합니다.
 
-또는 명령줄을 통해 설치할 수도 있습니다:
-
-```sh
-code --install-extension intlayer
-```
-
 ## 사용법
 
 ### 빠른 탐색
 
 1. **react-intlayer**를 사용하는 프로젝트를 엽니다.
-2. 다음과 같이 `useIntlayer()` 호출을 찾습니다:
+2. `useIntlayer()` 호출을 찾습니다. 예를 들어:
 
    ```tsx
    const content = useIntlayer("app");
    ```
 
-3. 키(예: `"app"`)에서 **명령-클릭**(`⌘+클릭` macOS) 또는 **Ctrl+클릭**(Windows/Linux)을 합니다.
-4. VS Code가 자동으로 해당 사전 파일을 엽니다. 예: `src/app.content.ts`.
+3. 키(예: `"app"`)에서 **Command-클릭**(`⌘+Click`, macOS) 또는 **Ctrl-클릭**(Windows/Linux)합니다.
+4. VS Code가 자동으로 해당 사전 파일(예: `src/app.content.ts`)을 엽니다.
 
 ### 콘텐츠 사전 관리
 
+### Intlayer 탭 (활동 표시줄)
+
+사전을 탐색하고 관리하려면 사이드 탭을 사용하세요:
+
+- 활동 표시줄에서 Intlayer 아이콘을 엽니다.
+- **검색(Search)**에서 실시간으로 사전과 항목을 필터링하려면 입력하세요.
+- **사전(Dictionaries)**에서는 환경, 사전, 파일을 탐색할 수 있습니다. 툴바를 사용하여 빌드(Build), 풀(Pull), 푸시(Push), 채우기(Fill), 새로고침(Refresh), 테스트(Test), 사전 파일 생성(Create Dictionary File)을 수행하세요. 사전에서 풀/푸시, 파일에서 채우기 등의 컨텍스트 작업은 마우스 오른쪽 버튼 클릭으로 실행할 수 있습니다. 현재 편집 중인 파일은 해당되는 경우 트리에서 자동으로 표시됩니다.
+
 #### 사전 빌드하기
 
 모든 사전 콘텐츠 파일을 생성하려면:
@@ -92,61 +142,42 @@ code --install-extension intlayer
 Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
 ```
 
-**Build Dictionaries**를 검색하고 명령을 실행하세요.
+**Build Dictionaries**를 검색하여 명령을 실행하세요.
 
 #### 사전 푸시하기
 
 최신 사전 콘텐츠를 업로드하려면:
 
-1. **명령 팔레트**를 엽니다.
+1. **명령 팔레트(Command Palette)**를 엽니다.
 2. **Push Dictionaries**를 검색합니다.
 3. 푸시할 사전을 선택하고 확인합니다.
 
 #### 사전 풀하기
 
-최신 사전 콘텐츠를 동기화하려면:
+최신 사전 콘텐츠 동기화:
 
 1. **명령 팔레트**를 엽니다.
 2. **Pull Dictionaries**를 검색합니다.
-3. 풀 사전을 선택합니다.
-
-## 개발 및 기여
-
-기여하고 싶으신가요? 커뮤니티 기여를 환영합니다!
-
-저장소 URL: https://github.com/aymericzip/intlayer-vs-code-extension
-
-### 시작하기
-
-저장소를 클론하고 의존성을 설치하세요:
+3. 가져올 사전을 선택합니다.
 
-```sh
-git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
-cd intlayer-vs-code-extension
-npm install
-```
-
-> 확장 기능을 빌드하고 배포하기 위해 `vsce` 패키지와 호환되는 `npm` 패키지 관리자를 사용하세요.
-
-### 개발 모드에서 실행하기
-
-1. **VS Code**에서 프로젝트를 엽니다.
-2. `F5` 키를 눌러 새로운 **확장 개발 호스트(Extension Development Host)** 창을 실행합니다.
+#### 사전 채우기
 
-### 풀 리퀘스트 제출하기
+프로젝트의 콘텐츠로 사전을 채웁니다:
 
-확장 기능을 개선하셨다면, [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension)에서 PR을 제출하세요.
-
-## 피드백 및 이슈
-
-버그를 발견했거나 기능 요청이 있나요? 우리의 **GitHub 저장소**에 이슈를 열어주세요:
+1. **명령 팔레트**를 엽니다.
+2. **Fill Dictionaries**를 검색합니다.
+3. 사전을 채우기 위해 명령을 실행합니다.
 
-[GitHub 이슈](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+#### 사전 테스트
 
-## 라이선스
+사전을 검증하고 누락된 번역을 찾습니다:
 
-Intlayer는 **MIT 라이선스** 하에 배포됩니다.
+1. **명령 팔레트**를 엽니다.
+2. **Test Dictionaries**를 검색합니다.
+3. 보고된 문제를 검토하고 필요에 따라 수정합니다.
 
 ## 문서 이력
 
-- 5.5.10 - 2025-06-29: 초기 이력
+| 버전   | 날짜       | 변경 사항   |
+| ------ | ---------- | ----------- |
+| 5.5.10 | 2025-06-29 | 이력 초기화 |