Skip to content

Conversation

@lacolaco
Copy link
Collaborator

概要

未翻訳ドキュメントを自動的に追跡するGitHub Issueを実装しました。mainブランチへのpushやIssueイベント時に自動更新されます。

実装内容

新規ファイル

  • .github/workflows/sync-untranslated-issue.yml: ワークフロー定義
  • .github/scripts/sync-untranslated-issue.mjs: Issue更新ロジック

既存ファイル修正

  • tools/list-untranslated.ts: --jsonフラグ追加
    • JSONフォーマットでの出力に対応
    • ファイルのカテゴリ分類機能を追加
    • tutorialのconfig.json除外

主要機能

1. 自動Issue更新

  • mainブランチへのpush時に未翻訳ファイルリストを自動更新
  • 単一のTracking Issue(「Tracking: 未翻訳ドキュメント一覧」)を継続的に使用
  • 誤ってクローズされた場合は自動的にreopen

2. カテゴリ別表示

未翻訳ファイルを9つのカテゴリに分類して表示:

  • 📖 Guide
  • 🎓 Tutorial
  • 📚 Reference
  • ⚡ Best Practices
  • 🔧 CLI
  • 🛠️ Tools
  • 🌐 Ecosystem
  • 🧩 Components/App
  • 📦 その他

3. Translation Checkout Issue連携

  • 「type: Translation Checkout」ラベルのIssueを自動検出
  • 翻訳宣言されたファイルをチェックボックスでマーク
  • ディレクトリ名での宣言に対応(前方一致)
  • Issue番号へのリンクを自動追加

4. 便利なリンク

各ファイルに以下のリンクを自動生成:

  • GitHubソースコードへのリンク
  • angular.jpプレビューURL(.mdファイルのみ)
  • 翻訳宣言Issue作成リンク(未宣言ファイル)
  • Translation Checkout Issue番号(宣言済みファイル)

トリガー条件

  • push to mainブランチ
  • issues イベント(opened, closed, reopened, labeled)
  • workflow_dispatch(手動実行)

動作確認

forkリポジトリで以下を確認:

  • ✅ 126件の未翻訳ファイルが正しくカテゴリ分類されて表示
  • ✅ Translation Checkout Issueとの連携が正常に動作
  • ✅ ディレクトリ名での翻訳宣言に対応(前方一致マッチング)
  • ✅ Issue番号がシンプルな#num形式で表示

- Add --json flag to tools/list-untranslated.ts
- Create GitHub Actions workflow for automatic issue updates
- Implement issue update script with category grouping
- Add pre-filled issue creation links for each file
@lacolaco lacolaco merged commit 0b86a1d into angular:main Nov 21, 2025
4 checks passed
@lacolaco lacolaco deleted the feature/untranslated-tracking-issue branch November 21, 2025 05:34
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.

1 participant