tipで更新されたドキュメントがないかをチェックする - gophersjp/go GitHub Wiki

目的

翻訳している内容がtipで更新された場合にそのbehindをわかるようにする。 結果はリスト形式で公開できるようにする。

案1: doc.goや*.htmlに書いてもらっている翻訳時のリビジョンURLへアクセスしてそこの更新を探る

メリット:

  • URLにアクセスして更新チェックするだけなので簡単。
  • 差分があればcode.google.comのリンクを表示できる。

デメリット:

  • おそい。
  • 各ドキュメント毎にアクセスするため、code.google.comに迷惑。

案2: doc.goや*.htmlに書いてもらっている翻訳時のリビジョンタグをリポジトリから見て更新を探る

メリット:

  • リポジトリをチェックアウトしてからリビジョンタグで確認するため早い

デメリット:

  • diffが見えにくい

実現方法:

  1. goリポジトリをチェックアウト $ hg clone https://code.google.com/p/go
  2. gophersjp/goの各ドキュメントのタグを抽出
  3. diffを見る 例: $ hg diff src/cmd/5a/doc.go -r 3633a89bb56d
  4. 結果を集計する