MDN Web Docs に日本語翻訳でコントリビュートしたくなる

https://toukatsu.connpass.com/event/357042/

Transcript

1. MDN Web Docs に日本語翻訳で 
 コントリビュートしたくなる 
 【初学者歓迎】東葛.dev in 柏 LT交流会【第7回】（増枠）
 うーたん

2. 実際にコントリビュートしたい方はこちら 
 MDN 月例ミートアップ - 翻訳ガイド · HonKit
 https://mozilla-japan.github.io/mdn-translation-guide/
 

3. 詳細な手順を zenn にまとめてみました 
 MDN Web Docs に日本語翻訳でコントリビュートする https://zenn.dev/u_tan/articles/dee192a68cc85e
 

4. このスライドを見ればコントリビュートのハードルも下がって、 
 コントリビュートしたくな〜る〜 （はず）

5. 自己紹介
 5
6. 自己紹介
 • うーたん
 ◦ 𝕏：@uutan1108
 • 株式会社ゆめみ
 ◦ サーバーサイドエンジニア
 ◦ 技術広報
 イベント開催するので 
 来てください！！ 
 6
7. MDN Web Docs とは

8. MDN Web Docs とは
 MDN Web Docsは、ウェブ標準及びMozillaプロジェクトの開発文書のための Mozillaの公式ウェブサイトである。以前の名称はMozilla Developer Network (モジラ・デベロッパー・ネットワーク、略称: MDN)。
 
 MDN Web Docsは開発者向けの資源であり、開発者や技術ライターのコミュ ニティによって維持されており、HTML5、JavaScript、CSS、ウェブAPI、 Django、Node.js、WebExtensions及びMathMLといった様々な話題に多くの 文書をホストしている。モバイルウェブ開発者向けに、MDNはHTML5モバイル アプリ、モバイルアドオンの構築、位置認識アプリといった話題に関する文書を 提供している。
 引用元：https://ja.wikipedia.org/wiki/MDN_Web_Docs

9. MDN Web Docs は GitHub で管理され、 
 翻訳プロジェクトも GitHub で管理されている 

10. MDN Web Docs の翻訳プロジェクト 
 - mdn/translated-content で様々な言語のドキュメントが 管理されている。
 - 日本語ドキュメントも管理されている。
 - 日本語話者がメンテナーで日本語翻訳のプルリクエスト をレビューしてくださる。
 - 他の言語だと海外の方がレビューしてくださる。

11. 管理されているドキュメント 
 fr：フランス語
 ja：日本語
 ko：韓国語
 pt-BR：ポルトガル語（ブラジル）
 ru：ロシア語
 zh（zh-CN と zh-TW）：中国語（簡体字 と 繁体字）
 es：スペイン語

12. 色々翻訳したり修正してみた 

13. 日本語に翻訳 
 https://github.com/mdn/translated-content/pull/24679

14. でかい修正を出してしまったが優しくレビューしてくれた 
 https://github.com/mdn/translated-content/pull/24765

15. 優しい世界 

16. やってみて 

17. 翻訳は大変だが、準備は簡単 

18. ざっくり手順 
 1. Node.js と Git が使える状態にする
 2. 翻訳されてないドキュメントを探す
 3. 翻訳する
 4. プルリクエストを出して、レビューされ、マージされる
 5. 翌日ごろには公開されている

19. 「翻訳されてないドキュメントを探す」 

20. 自動で未翻訳ページがまとめられている 

21. https://mdn.lavoscore.org/?regex_b=glossary&sort=size-asc&filter=not-ja

22. 探す手間が０。とても便利。 

23. 「翻訳する」 

24. 翻訳する際に注意することリンク集 
 - 表記ガイドライン https://github.com/mozilla-japan/translation/wiki/Editorial-Guidel ine
 - L10N ガイドライン https://github.com/mozilla-japan/translation/wiki/L10N-Guideline
 - Mozilla 用語集 https://github.com/mozilla-japan/translation/wiki/Mozilla-L10N-G lossary
 - 日本語の文体 https://docs.google.com/spreadsheets/d/1y-hC-xMXawCgcYZwJD nvuSlAOTgMRLLyqXurpYkJbYE/edit#gid=0

25. 表記に気をつける 
 - 「コンピューター」のようにすべて長音を付加する。
 - 日本語と英数字の間には半角スペースを挿入する。
 - など...
 プルリクエストを出す前に 
 翻訳した文章を確認してみる。 

26. 「プルリクエストを出す、レビューされる、マージされる」 

27. https://github.com/mdn/translated-content/pull/24679

28. 日本語話者の方がレビュー、マージしてくださる 

29. 私がプロジェクトを知ったきっかけ 

30. Open Source Conference 2024 Tokyo / Fall

31. https://x.com/mozillajp/status/1849976683543384359

32. ここで以下のページの QRコードが書かれたミニ チラシを貰ったのがきっかけ 
 MDN 月例ミートアップ - 翻訳ガイド · HonKit
 https://mozilla-japan.github.io/mdn-translation-guide/
 

33. 次回の Open Source Conference は？ 

34. Open Source Conference 2025 Tokyo/Fall
 
 2025年10月25日(土) 10:00～16:00
 東京都立産業貿易センター台東館 

35. Open Source Conference 2025 Tokyo/Fall
 
 2025年10月25日(土) 10:00～16:00
 東京都立産業貿易センター台東館 
 技術書同人誌博覧会 もブース出すはず

36. 技術書同人誌博覧会 

37. 第十二回 技術書同人誌博覧会 
 
 2025.10.26 Sun. 10:30~16:00
 @大宮ソニックシティ 

38. 東葛.dev もサークル参加するっぽい。
 著者も募集してるっぽい。
 第十二回 技術書同人誌博覧会 
 サークル参加募集中 

39. お わ り