数年前、プログラマー兼ライターのバーナード・マイスラー氏は、プログラマーが悪いソフトウェアを書くのは、プログラマーが下手なライターだからだと主張しました。
「ほとんどのエンジニアは、段落をつなげて書くことはおろか、一貫した文章をひとつも書けない」と彼は書いている。
そのため、ソフトウェア エンジニアがドキュメントを作成する場合、一貫性のない API の説明が他のプログラマーを混乱させ、下流のコードに影響を与えると彼は推論しました。
Mozillaは、ある種の解決策を計画している。誰もが上手に文章を書けるように教えたり、難解な技術仕様の弊害を終わらせたりはできないものの、FirefoxとRustプログラミング言語の開発元であるMozillaは、Google、Microsoft、Samsung、そしてW3Cと提携し、ウェブの事実上のハウツーマニュアル、通称Mozilla Developer Network(MDN)を統合し、明確化する取り組みを進めている。
もちろん、Web テクノロジーを解説したオンライン リソースは他にも多数存在しますが、12 年の歴史を持つ MDN (誰でも参加できる wiki) は最も広く使用されているリソースの 1 つであり、毎月 600 万人のデザイナーや開発者がアクセスしています。
Mozilla とその関係者は、Microsoft と Google の協力を得て、MDN をすべての Web 開発を統括する唯一のマニュアルにすることで、MDN の人気がさらに高まることを期待しています。
Mozillaの開発者エコシステム責任者であるアリ・スピヴァック氏は、水曜日にThe Registerとの電話インタビューで、Google、Microsoftをはじめとする企業がMDNに非公式に貢献してきたと述べた。数ヶ月前、各社は製品諮問委員会を通じて関係を正式なものにすることを決定したとスピヴァック氏は述べた。
「製品諮問委員会と他者からのより多くの意見の副次的効果の一つは、我々がリソースをより効果的に配分できるようになることだと期待している」とスピヴァック氏は語った。
CSSはHTMLのテーブルレイアウトを廃止するはずだったって知ってる?二度目の正直:CSSグリッドの登場
続きを読む
彼女は、さまざまなベンダー間のより協調的なコミュニケーションによって開発者により良い情報を提供できたかもしれない例として、比較的最近さまざまなブラウザで CSS グリッド サポートがデビューしたことを取り上げました。
この提携の結果、EdgeとInternet Explorerの開発元であるMicrosoftは、Web標準ドキュメントの拠点としてMDNを「全面的に」サポートすると発表しました。Windowsの巨人であるMicrosoftは、APIリファレンスライブラリをMDNにリダイレクトする予定です。
「開発者は、標準化団体、ブラウザベンダー、サードパーティにまたがるAPIドキュメントを追いかける必要はない。コミュニティによって維持管理され、すべての主要ベンダーによってサポートされている単一の正規のソースが存在するべきだ」と、マイクロソフトのシニアコンテンツ開発者であるエリカ・ドイル・ナバラ氏はブログ投稿で述べた。
Google はまだそこまでには至っていないが、MDN を Web 開発者にとって最高かつ最新のドキュメントにするためにグループと協力できることに興奮していると述べている。
MDN はすでに調査で高い評価を得ており、Slashdata の最近の調査ではドキュメンテーション カテゴリでトップに立っています。
「これは、私たちがさらに改善するのに役立つだろう」とスピヴァック氏は語った。
懐疑的な人たちは、サードパーティの JavaScript フレームワークとライブラリの標準以下のドキュメントが今後も開発者を悩ませ、誤ったコードをサポートし続けるだろうと安心できます。®