MDN 20周年を記念

• MDN Web Docs が20周年を迎え、ウェブ業界の バースデーケーキの伝統 について紹介
• ブラウザベンダーには、競争の中の協力 を記念して主要な節目ごとに互いへケーキを贈る伝統がある
• 今回のMDNの誕生日は、web.dev チームからのケーキの贈り物 で祝われた
• MDNの発展には、世界中のコミュニティと10万人を超える貢献者 たちの努力が不可欠だった
• 今後も、開発者の力を高め、より良いウェブを築くという 共通の目標 に向けた取り組みを強調

---

MDN Web Docs 20周年記念

ウェブ業界のケーキ文化

• ウェブのエコシステムでは、バースデーケーキ が特別な意味を持つ
• ブラウザ開発企業は、主要製品のリリースや節目 を祝うたびに、互いにケーキを贈る伝統を受け継いできた
  • Microsoft は Firefox 2、3、4 の各バージョン発売時に Mozilla へケーキを送ったことがある
  • Mozilla も IE10 の発売に合わせて Microsoft へケーキを送ったことがある
• この伝統は、競争と協業が共存するウェブ開発文化 をよく表す象徴でもある

MDNの20回目のバースデーケーキ

• 今回のMDN 20周年では、web.dev チーム からお祝いのケーキを受け取った
• MDN運営チームは、おいしいケーキを送ってくれた web.dev チームをはじめ、今日のMDNを形作ってきたすべての パートナー、同僚、コミュニティ に感謝を伝えた

MDNコミュニティとグローバルパートナーシップ

• MDNの発展には、数多くの開発者と10万人を超える貢献者 たちの活動が大きな役割を果たしてきた
• 個別に言及できなかった多くのメンバーもいるが、その 情熱、好奇心、直接的な貢献 のおかげでMDNは成長することができた

これからの抱負

• MDNチームは、世界中の開発者の力を高めること と、より良いウェブを共につくっていく目標を強調した
• 過去20年間の経験を土台に、今後20年も同じ目標のもとで 継続的な協力と成長 を目指すとしている

[GN⁺]

Hacker News の意見

• MDN は間違いなく重要な参考資料だ。こうした複雑な現代の Web 技術を文書化するのは難しいことなのに、本当によくやっていると思う。ただ、少し気になる点が 2 つある。1 つ目は、たまに MDN でやや疑問の残る内容を目にすることがある点だ。たとえば JavaScript フレームワークとライブラリに関するチュートリアル は、公式チュートリアルと比べて特別な価値があるとは思えない。特に Svelte のチュートリアルは 5 年前の内容で、今の状況には合っていない。2 つ目は、webextension ドキュメントの品質が低いのが残念だ。大半が manifest v2 基準で、v3 や Chrome 互換性に関する内容は不完全にしか触れられていない。実際、この文書で開発していて Chrome の公式ドキュメントに移る必要があった。Firefox をメインターゲットにしていたにもかかわらずだ
  • 私は MDN チームの者です。称賛とフィードバックを本当にありがとうございます！ ご指摘は必ずチームに共有します。Firefox 拡張機能の作成についてさらに学びたいなら、extensionworkshop.com を参考にするとよいと思います
  • MDN に時々疑わしい内容があるという点には強く同意する。MDN はユーザー側のライブラリやフレームワークよりもずっと長く生き残らなければならない。Vercel が MDN ユーザーを自社フレームワークへ流入させる方法を見つけるのではないかと気になってしまう
• MDN がまだ存続していて、しかも更新され続けているのは本当にうれしい。2020 年にチーム全員が解雇されたものだと思っていたので、その後チームを再編したのか気になる。関連 HN 議論リンク
  • 私は MDN チームの者です。当時、チームは一時的に 2 人と一部の契約スタッフまで縮小していましたが、今はかなり成長しました。現在は 15 人の正社員と契約スタッフ、そして広いパートナーおよび貢献者ネットワークが MDN を最新の状態に保っています。詳しくは 私たちのチーム紹介 をご覧ください
  • この状況は本当に不可解だ。Mozilla がチーム全体を解雇したのに、なぜ Mozilla ドメインが mdn の誕生日を祝っているのか理解できない
  • MDN ドキュメントの大部分は OpenWebDocs のおかげだ。これはボランティアと複数の技術企業によって共同運営されている。openwebdocs.org
  • コードはオープンなので、誰がどのように貢献しているかを自分で確認できる。貢献者統計 を見ると、最近の主要な貢献者の多くは Mozilla 社員ではないようで、Yale 所属、フリーランサー（おそらく Mozilla から報酬を受けている）、そしてさまざまな企業から参加している雰囲気だ
• MDN のおかげで、子どもの頃の夢だった Space Invaders のようなゲームを大人になってから自分で作ることができた。Canvas API と OscillatorNode に関する素晴らしいドキュメントのおかげで、ゲーム開発の入り口が本当に容易だった。私が作ったゲーム、プロジェクトの動機 もどうぞ
  • ゲームプレイは本当に素晴らしかった。敵の速度、数、降下のスピードなど進行のしかたがよく、敵の弾を撃てる点も面白かった。オリジナルの Invaders とどれほど違うのかはよく分からないが、短い休憩にぴったりのすてきな体験だった。ありがとう
  • あなたの夢をかなえるのに MDN が役立ったと聞けて本当にうれしいです！ フィードバックは必ずチームに伝えます
• 私は 20 年近く、MDN を最もよく参照する Web ドキュメントとして使ってきた。MDN は不可欠なリソースだ。公式仕様よりはるかに読みやすく、実例や相互参照、簡単な playground まで提供してくれる。そのおかげで継続的に活用している
• MDN で見慣れない機能を学ぶのが簡単でないことは多い。時には文書を見て「これはいったい誰のためのものなんだ」と思うこともある。2 段落ほど読んでも、それが何の機能で、どんな問題を解決しようとしているのか見当がつかない。そのテーマについて細部まで知らなければ、読んでも何も残らない。むしろ仕様書のほうがより多くの背景情報を得られることすらある。MDN が存在していること自体はうれしいが、CSS: The Definitive Guide がしてくれる説明くらい明快であってほしい。私は MDN の文書では 1 年以上 CSS を学べなかったが、CSS: The Definitive Guide を読んだら 3 か月で完全に理解できた。この本レベルの説明を継続的に補強した wiki 形式のものを持ち、情報自体は最新の MDN 参照資料で保つ仕組みがあるなら、有料でもぜひ使いたい
  • MDN チームのメンバーです。貴重なフィードバックを本当にありがとうございます。必ずチームに共有し、改善のポイントとして生かします。「誰のための文書なのか」という問いについて言えば、私たちの参照ページの大半は実際のブラウザ実装に基づいて作られています。仕様だけを文書化するのではなく、複数のブラウザに導入された機能に焦点を当てています。その情報を明確かつ中立的に、どの開発段階の人にもアクセスしやすい形で伝えようと努めています。それとは別に、最近は初心者向けの学習コンテンツも大きく増やしています。個々の開発者の成長段階に役立つカリキュラムを用意し、より深いトピックはブログで補完しています
  • 4〜5 年前には、MDN の例の一部が実際のブラウザで動作しないことがあり、fit-content 関数とキーワードの違いについても曖昧に説明されていたので、issue を起票した。その後、文書は修正された。しかし今では、以前のように issue を起票して修正してもらうやり方がうまく機能していないように見える。新しいフィードバックチャネルや修正プロセスが必要だ。過去の issue の例
• 無料サービスなのに、わざわざ記念コメントの場で不満をこぼす必要があるのか少し疑問だ。MDN の文書は 5 年以上使っているが、本当に貴重なリソースであると同時に、さまざまな実験を自然に促してくれる。自分で調べようとしなければ知らなかったようなすばらしい API や機能を、MDN のおかげで見つけられた。20 周年おめでとう
  • Stroustrup が言っていた「不満が出る言語と、誰にも使われない言語しかない」という話を思い出す。MDN は本当に必要なサービスだからこそ、多くの人がさまざまな意見を持つのだと思う。私は Web プラットフォームを少しかじる程度だが、MDN の文書は他の文書に比べていつも新鮮さを感じてきた
• MDN は本当に便利な資料だ。この 15 年間、毎月 1 回は DuckDuckGo で !mdn Array コマンドを使っているほどだ
  • コミュニティで mdn.io/array のリダイレクトも作られているので、そちらも活用できます！
• MDN に直接寄付する方法はあるのだろうか。Mozilla 全体に寄付するのではなく、MDN の運営に明確に使われるよう指定して寄付したい。それほど MDN は私にとって不可欠だ
  • Firefox も同じく毎日頼りにしている。ただ、Mozilla という組織にはますます失望が大きくなっている。Firefox と関係のないところに資源を割いている状況に失望しており、優先順位が改まるまでは追加支援をするつもりはない
• MDN は本当によく使っている。もしチームがこのコメントを読んでいるなら、SVG ドキュメントについて少し使いづらかった経験を共有したい。SVG 要素の説明があまりにそっけなく感じられた。たとえば 'g' 要素は 説明ページ で、使える attribute が何か、global attribute が何かについて具体的なリンクや説明が不足している。ページ上で属性一覧を簡単に把握できるべきなのに、自分で探しに行かなければならず面倒だ。"attributes" をクリックすると属性全体のリストは出るが、どれが global なのかがはっきりしない。こうした構成にはなじみにくく、API 構造体のドキュメントなら各 property をその構造体ページで全部説明してくれることを期待する。HTMLCanvasElement の ドキュメント のように、少なくとも各要素固有の属性と継承された属性が一目で整理されていてほしい。こうした部分はかなりの割合で IDL によって半自動化できそうに思える
• MDN を初めて知ったとき、まるで魔法使いの秘密の書庫に忍び込み、古文書を見ているような気分だった。Mozilla チーム、本当にすばらしい仕事だ