Skip to content

Conversation

@miyaichi
Copy link
Collaborator

@miyaichi miyaichi commented Jan 5, 2026

This PR establishes standardized guidelines and a glossary for Japanese translations of the UID2 documentation. It also updates the main overview documents to align with these new standards, resolving inconsistencies in terminology and tone.

Key Changes

  1. Translation Guidelines & Glossary

    • Created
      i18n/ja/TRANSLATION_GUIDELINES.md: Defines rules for style, tone, and formatting (e.g., using "desu/masu" style, keeping headers in English, using relative links).
    • Created
      i18n/ja/TRANSLATION_GLOSSARY.md: Defines standard translations for technical terms (e.g., handling of "Bid Request" vs "Bid Response", "Integration", etc.).
  2. Document Updates (Japanese Version)

    • Updated i18n/ja/intro.md and i18n/ja/summary-doc-v2.md to follow the new guidelines.
    • Translated/Updated all files in overviews/ directory:
      • overview-advertisers.md
      • overview-data-providers.md
      • overview-dsps.md
      • overview-publishers.md
      • participants-overview.md
      • overview-operators-private.mdx

Standardization Details

  • Bid Request/Response: Unified to Katakana terms "ビッドリクエスト" and "ビッドレスポンス".
  • Integration: Primarily translated as "インテグレーション" or "実装" depending on context, avoiding "統合".
  • Headers: Kept headers in English to maintain consistency with the original docs and facilitate cross-referencing.
  • High-level: Omitted or translated as "概要" to avoid unnatural phrasing in Japanese.

Motivation

Previous Japanese translations lacked consistency in terminology and style. These guidelines aim to improve the quality and readability of the documentation for Japanese users while making future translation work more efficient.

- Added TRANSLATION_GUIDELINES.md and TRANSLATION_GLOSSARY.md in i18n/ja/
- Updated summary-doc-v2.md and intro.md to follow new guidelines
- Translated/Updated all overview pages in overviews/ directory
- Standardized terms: Bid Request/Response, Integration, etc.
- Added English descriptions to translation rules for non-JP writers
Copy link
Collaborator

@genwhittTTD genwhittTTD left a comment

Choose a reason for hiding this comment

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

Looks great. Thank you so much.

@genwhittTTD genwhittTTD merged commit 1a4931f into main Jan 5, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants