로케일 정책
ONESHIM의 공개 표면은 사용자가 실제로 선택할 수 있는 언어와 내부 검증용 번역 리소스를 분리해서 관리합니다.
공개 문서
docs-site는 현재 한국어를 canonical 공개 문서로 운영합니다. Docusaurus 설정도 defaultLocale: "ko"와 locales: ["ko"]로 고정되어 있으며, 영어 문서 트리는 아직 사용자에게 노출하지 않습니다.
영어 공개 문서를 열 때는 다음 작업을 같은 PR 단위로 처리해야 합니다.
docs-site/docusaurus.config.ts에en로케일을 추가합니다.- 한국어 canonical 문서와 영어 문서의 페이지 수, sidebar 노출, 라우트 경계를 맞춥니다.
- 문서 빌드와 링크 검증을 영어/한국어 경로 모두에서 통과시킵니다.
- 자동 번역 초안은 reviewer 검수 전까지 공개 라우트에 연결하지 않습니다.
조직 콘솔
조직 콘솔에서 사용자가 직접 선택할 수 있는 지원 언어는 영어와 한국어입니다. 언어 선택 UI, 저장된 사용자 설정, 브라우저 언어 감지는 모두 en 또는 ko로만 수렴합니다.
일본어 리소스는 FuturePac 및 시뮬레이션 화면의 preview 검증 자산으로만 유지합니다. 이 리소스는 테스트에서 명시적으로 불러올 수 있지만, 전체 콘솔 로케일로 사용자에게 노출하지 않습니다. 일본어를 정식 지원 언어로 승격하려면 모든 namespace parity, 설정 화면 선택지, 사용자 문서, smoke 테스트를 함께 갱신해야 합니다.