GDG DevFest 2019 での登壇資料です https://tokyo.gdgjapan.org/devfest2019
TensorFlow のドキュメント翻訳を行うコミュニティ活動について
View Slide
杉山 阿聖Software Engineer @ Repro AI Labs機械学習, 統計, R&D, 開発TensorFlow Docs 翻訳 & レビュー翻訳:Performance with tf.functionレビュー: Tutorials などなど機械学習図鑑 共著
https://japan.googleblog.com/2019/12/books-for-students.html 3
1. イメージが伝わるようにするWeb エンジニアが雰囲気をわかる厳密さよりもわかりやすさ2. 数式を用いた詳細な記述は行わない日本語と図で頑張る機械学習図鑑4
ご推薦いただき本当にありがとうございました
ドキュメント翻訳は楽しい1. TensorFlow について詳しくなれる2. コミュニティで知識を交換しあえる3. 世界を変えることができる今日お伝えしたいこと7
Contents1. TensorFlow docs の翻訳について <-2. 翻訳の楽しさについて3. 翻訳活動の難しさについて
1. TensorFlow docs とは2. TensorFlow docs の翻訳活動について3. 日本コミュニティでのこれまでの活動についてTensorFlow docs の翻訳について9
TensorFlow docs10
tensorflow.org で提供されるドキュメントのうち、Guide, Tutorials などの総称tensorflow/docs というリポジトリで管理される内容は TensorFlow Core, tfjs, tf.lite, tfx, Swift for TensorFlow と幅広い独自のリポジトリ内で別にドキュメントを作成している場合も例: tensorboard/docsTensorFlow API reference は別枠扱い (docsrting で書かれる)TensorFlow docs とは11
Markdown と Jupyter Notebookで構成されているNotebook は Colab で起動できるdark mode がある特徴12
TensorFlow 2 quickstart for expertsDemo13
ドキュメントは英語で書かれたものを source-of-truth として取り扱う各国語への翻訳は、各国のコミュニティ主導で行われているTensorFlow docs の翻訳活動14
11 ヶ国語への翻訳が進行中15
TensorFlow 2 quickstart for beginnersDemo16
時期 内容2019/03 @masa-ita による ja/tutorials/kerasの翻訳 PR2019/04 レビューが行われ PR が取り込まれるオフライン活動 (TensorFlow のドキュメントを翻訳しつつ勉強する会#1)2019/05 Keras, hub, tfjs, xla, autograph の翻訳に関する PR が merge2019/06 tutorial や tf.lite, tfp も翻訳が進み PR が merge される2019/08 レビュワーが増えだす (2019/12 現在 8 名)2019/11 オフライン活動 (TensorFlow のドキュメントを翻訳しつつ勉強する会#2)日本コミュニティでのこれまでの活動17
すべての始まり18
続々と集まるレビュワー (1/2)19
続々と集まるレビュワー (2/2)20
リリース21
翻訳活動をすすめるためのコミュニティが立ち上がるオフライン & オンラインで活動を開始オフラインで翻訳するイベントを2 回開催オンラインでは随時 GitHub &Slack で活動継続中コミュニティ活動22
TensorFlow を翻訳しつつ勉強する会 #223
Google Developers ML SummitTokyo vol 3 で紹介されるJeff Dean が来日した会写真に写っている方はMike Liang (Product Manager,TensorFlow)ML Summit Tokyo24
現在も活発に活動中25
Contents1. TensorFlow docs の翻訳について2. 翻訳の楽しさについて <-3. 翻訳活動の難しさについて
1. TensorFlow について詳しくなれる <-2. コミュニティで知識を交換しあえる3. 世界を変えることができる翻訳の楽しさについて27
内容が豊富深く理解できる得た知識の活用例 tf.functionによる高速化1. TensorFlow について詳しくなれる28
Tutorial だけでもさまざまな内容のドキュメントが用意されているKerasNumpy, pandasCNN, RNNWord embeddingTransfer learningGAN内容が豊富29
TensorBoardTFXTensorFlow HubDatasetsModel OptimizationProbabilityTensorFlow FederatedXLANeural Structured LearningTensorFlow AgentsTensorFlow RankingExtensions (一部)30
翻訳することは、理解したことを自分の言葉で他人に伝えることと同じ英語のドキュメントを読み、動かして理解する関連するドキュメントを読み、動かして理解する結果を自分の言葉で記述する翻訳は自分の理解度に対する良いテストになる翻訳することで理解を確認できる31
様々な分野の理解が必要になった例 : TFX32
better performance with tf.function.ipynb得た知識の活用例 tf.functionによる高速化33
翻訳を行い、理解度をテストしながら読むことで、理解を深められる分野が幅広いため、自分の引き出しを広げられる1. TensorFlow について詳しくなれる34
1. TensorFlow について詳しくなれる2. コミュニティで知識を交換しあえる <-3. 世界を変えることができる翻訳の楽しさについて35
理解を深められる互いに褒め合うのは大事2. コミュニティで知識を交換しあえる36
TensorFlow Core のドキュメントの翻訳には大まかに言って次が必要機械学習の知識プログラミングの知識 : Python, OOP, Functional ProgrammingTensorFlow の知識TensorFlow Core 以外を翻訳しようとすると、追加の知識が必要TensorFlow.js : JavaScripttf.lite, XLA : 低レイヤーTFX : Apache Beam, Apache Airflow, Kubeflow (k8s), etc.Swift for TensorFlow : Swifttfp : 確率的プログラミング... and so on.翻訳には莫大な知識が必要になる37
自分の理解を確認し、理解の幅を広げる機会はなかなかないレビューを通して、コミュニティで自分の理解を深められる自分の知識が深くない分野について、改めて見直す機会になる理解を深められる38
文中の Python primitives はどう訳せるでしょうか？tf.function works best with TensorFlow ops, rather than NumPy ops or Pythonprimitives.
40
41
42
より良い訳が思いついたあなた！今がまさにコントリビュートの機会です！
互いに褒め合うのは大事44
互いに褒め合うのは大事45
互いに褒め合うのは大事46
指摘も大事、互いに褒め合うのも大事コミュニティ活動を通じて適切なフィードバックが得られる2. コミュニティで知識を交換しあえる47
1. TensorFlow について詳しくなれる2. コミュニティで知識を交換しあえる3. 世界を変えることができる <-翻訳の楽しさについて48
1. 日本語のドキュメントに助けられてきたから2. 翻訳することで世界を変えることができるなぜ翻訳したいのか？49
Q: manってどう読むんですかA: man manQ: manってどうやったら読めるようになるんですかA: 読もうとするうちに読めるようになるQ: manコマンドってどうやったら終えられるんですかA: man lessを読めQ: 打てないんですがA: hを打てmanを読め50
51
52
大量の日本語ドキュメントが見つかる安心感 (黒い画面じゃない)少なくとも同じことで悩んでいた人がいた！仲間がいた！なぜ検索するのか53
今読めるのは先人の努力の結果最初からできたわけではない返すべき恩がある巨人になれなくとも、巨人の肩までの階段なら作れるかもしれない日本語のドキュメントに助けられてきた54
誰がこんな難しいことをやるのか単純に英語の文章を読めばよいのではないかいつの日にか公式的にやってくれるのではないかでも、少なくとも TensorFlow のドキュメントについてはそうではない自分で理解して、他人にわかるように説明したドキュメントがある世界は、それがない世界よりもずっと良い先人たちもそのような思いだったのでは他人にわかるように説明すること = 翻訳で恩返しをして、より良い世界にできるやってみたら意外と楽しいし！TensorFlow のドキュメント翻訳についての雑感55
1. 今、ドキュメントを読めるのは先人の努力のおかげ2. 翻訳を行うことで自分で理解して他人にわかるように説明したドキュメントのある世界を実現できる3. 世界を変えることができる56
Contents1. TensorFlow docs の翻訳について2. 翻訳の楽しさについて3. 翻訳活動の難しさについて <-
0. 翻訳活動の根本的な難しさ1. 手順が不明確2. 未着手が多い3. 変更への追従ができていない翻訳活動の難しさについて58
コミュニティを作り定着させることが大事日本コミュニティについては一山越えた感翻訳活動の根本的な難しさ59
少人数で活動してきていたため、手順が不明確な箇所がまだある右は翻訳すべきでないドキュメントを翻訳した筆者に対する丁寧な対応の図Jupyter Notebook のレビューも現状では jsonを気合でレビュー勢が多い1. 手順が不明確60
表記ゆれチェックツールMarkdown とNotebook に対応Thanks:sfujiwarachie8842Proofreading(RedPen)61
着手できたのはファイル数でja / en = 65 / 228 (29%) くらいtensorflow/docs に限定して diffを撮ってみたのが右図関連ドキュメントを含めると比率はまだ下がりそうまだまだやることはたくさんある個人的には TFX と Swift forTensorFlow をやっていきたい2. 未着手が多い62
ドキュメントの変更が結構激しく、追従ができていない急速に拡大するTensorFlow エコシステムへの追従も考慮できると良さそう3. 変更への追従63
翻訳以外にも英語ドキュメントの修正を行うケースもドキュメントとコードの不整合やリンク切れを修正ドキュメントそのものを追加するケースも英語ドキュメントの修正64
0. コミュニティを立ち上げ翻訳活動を継続できた1. 活動を継続する中で手順が不明瞭になっているので明文化していきたい2. まだまだ翻訳に着手できていない分野も多いのでフロンティアが広がっている3. 変更に追従するのは短時間でできるので最初はこれからやると良いかも4. 英語ドキュメントの修正や追加もやっていきたい翻訳活動の難しさについて65
We are lookingforward to seeingyour contribution!
asei
.jpg){kind=avatar}
izzii
colopl
konifar
pingcap0315
nasa_desu
edwardkenfox
guchey
junki
lmt_swallow
pf_businessdivision
yuneco
eileencodes
malarkey
philnash
addyosmani
mongodb
matthewcrist
frogandcode
kastner
maggiecrowley
roundedbygravity
kneath
stephaniewalter