確かに、かなり理論的な質問です。
そして、図書館利用者というより、図書館設計者の視点でお聞きしたいです。目標は、ユーザーにとって可能な限り簡単なデザインを提供することですが。
特定のインターフェイスが常にユーザーによって実装されることになっていることを伝える方法のガイドライン/ベストプラクティスはありますか? または、ファクトリ関数が提供されており、そのインターフェイスを実装する合理的なオブジェクトを作成していますか?
もちろん、ほとんどの場合、これは文脈から明らかなはずです。パラメータとしてそのようなインターフェースを期待する別のライブラリ関数は、それをどこから取得するかは一目瞭然です。それは単なるチェーンのリンクになるからです。しかし、かなり進化したシステムやライブラリが、もはやそれほど簡単に理解されなくなっていることを想像できる人もいると思います。
ファクトリ関数がどこかにあるのか、ユーザーが常に独自の実装を提供する必要があるのか という基本的な質問に関して、インターフェースの理解がますます難しくなるのをどのように防ぐことができますか?
答えはコメント、ドキュメント、またはコードにありますか?
ファクトリ関数は常にインターフェイスのすぐ近くで宣言する必要があると思います。そうでない場合は、何もありません。しかし、これが柔らかすぎるガイドラインなのか、それとも常に実現できないのかはわかりません。