
528
29
章 あなたの
API
はどれくらい使いやすいか?
す。
シナリオベース設計では、各シナリオごとにそれを達成するために開発者が書くものと期待される
コードを
API
設計者が書きます。設計者はサンプルコードを書く際に、認知次元に基づいて開発者の
選好を考慮します。つまり、開発者の弟子となって、開発者が振舞うであろうように振舞うわけです。
その過程において、
API
設計チームは認知次元フレームワークを設計しているものに対するチェックリ
ストとして使用することができます。作成した各コード例についても、レビューを行ってシナリオがター
ゲットとしている開発者の選好に合致していることを確認します。シナリオについて十分満足行く結果
となったら、はじめてそのシナリオを実現できるような
API
を設計し構築するのです。
もちろん、いったん実装が開始された後も、設計について予期しなかった疑問が生じることがありま
す。そのような場合は、チームは構築しているシナリオを参照し、その疑問がシナ
リオにもたらし得る
影響について検討します。その際、設計チームは
API
の全体アーキテクチャに対してではなく、複数
の
API
のユーザエクスペリエンスに対して着目します。シナリオに基づいて素晴らしいエクスペリエ
ンス群を提供すべく努めることで、
API
が使いやすいとはどういう意味か、十分な理解に立脚した
API
を開発するという立場に常に立って、設計上の選択が行えます。
API
設計におけるシナリオベースのアプローチは、
API
設計者の考え方を
API
が「何であるか」 ...