Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

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

Avatar for uutan1108

uutan1108

July 05, 2025
Tweet

More Decks by uutan1108

Other Decks in Programming

Transcript

  1. 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

  2. MDN Web Docs の翻訳プロジェクト 
 - mdn/translated-content で様々な言語のドキュメントが 管理されている。
 -

    日本語ドキュメントも管理されている。
 - 日本語話者がメンテナーで日本語翻訳のプルリクエスト をレビューしてくださる。
 - 他の言語だと海外の方がレビューしてくださる。

  3. ざっくり手順 
 1. Node.js と Git が使える状態にする
 2. 翻訳されてないドキュメントを探す
 3.

    翻訳する
 4. プルリクエストを出して、レビューされ、マージされる
 5. 翌日ごろには公開されている

  4. 翻訳する際に注意することリンク集 
 - 表記ガイドライン 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