A Better Project@はてなダイアリー(インポート版)

基本的にここは更新されません。詳細はaboutへ。

Mozilla のインターフェースドキュメントの今後

さよなら XulPlanet - Firefox Hacks 翻訳日記/ウェブリブログにもある通り、数多くの Mozilla のインターフェースのドキュメントを提供していたXulPlanet が消滅状態となり、Mozilla のインタフェースドキュメントは今後、MDC に一本化されることになりそうです。このインターフェースドキュメントは IDL から自動生成される仕組みになっているのですが、コメントがきちんとなされていないなどの理由で、自動生成だけでは質に問題がある、と MDC のリーダー Sheppy がブログに書いています。
Bit Stampede » Blog Archive » Thoughts on automated documentation generation
MDC には Writing interface reference documentation というドキュメントがあり、IDL からこれに沿ったドキュンメントを自動生成する仕組みを作り、それから、手動で編集を加えて、ドキュメントの質を上げるという方向のようです。量と質の両立は難しい問題ですが、MDC は Wiki であるということの特性を活かし、インターフェースのドキュメントの質に向上に興味を持つ貢献者が増えてくれればと思います。