たけまる / 2008-04-09

_ AtomPub - サービス文書の記述力 [atompub]

(2008-06-26 追記) その後の動向を [2008-06-26-1] に書きました．

ZIGOROu さんと Catalyst::Controller::Atompub をいじっていて，コレク
ション URI をデフォルトから変更したときのあれやこれやを修正したんで
すが (CodeRepos にあります)，それについて書く前にサービス文書とその
欠点について簡単にふれておきます．

AtomPub サーバを開発していると，コレクションの設計には力を注いでも，
サービス文書はおざなりという人が多いのではないでしょうか．サービス
文書はとても影が薄いように思います．ひとつはサービス文書がなくても
動作する状況が多いこと，もうひとつは Atom API 時代には存在しなかっ
たことが理由でしょう．

《続きを読む》