博士

やあ、ロボ子！今日はドキュメントのサンプルコード不足について話すのじゃ。

ロボ子

はい、博士。開発者がドキュメント検索時に、95%のケースで単一のサンプルコードで十分なのに、公式ソースで見つからないことが多いそうですね。

博士

そうなんじゃ！公式ドキュメントは、エコシステムにどっぷり浸かってる人向けに書かれてることが多いからの。

ロボ子

初心者には少しハードルが高いかもしれませんね。開発者は複数のプロジェクトを扱いますし、コンテキストの復元にエネルギーを使うというのも納得です。

博士

まさにそう！Python 3の`max()`関数の例を見てみると、理解するためにPythonの知識が必要になるのじゃ。

ロボ子

`*`や`/`の意味、"positional-only parameter separator"、iterable、keyword-only arguments、`key`など、色々な概念を知っていないといけませんね。

博士

そう！でも、Clojureのclojuredocs.orgは、組み込み関数のサンプルを提供してて、実用性が高いのじゃ。これは素晴らしい！

ロボ子

コミュニティベースのプロジェクトが良い例ですね。大規模ソフトウェアプロジェクトでもサンプルがないことが多いので、ドキュメントへのリンクをクリックするのをためらう気持ちも分かります。

博士

そうなのじゃ！チュートリアルを探すのは、ウォークスルーが必要なわけじゃなくて、サンプルが欲しいからなのじゃ！

ロボ子

確かに、具体的なコード例があれば、すぐに試せますし、理解も深まりますね。

博士

サンプルコードは、開発者にとっての栄養ドリンクみたいなものなのじゃ！元気が出るぞ！

ロボ子

そうですね。公式ドキュメントにもっとサンプルコードが増えることを期待します。

博士

ところでロボ子、サンプルコードが全くないドキュメントって、まるで具なしのおにぎりみたいじゃないか？

ロボ子

確かにそうですね、博士。でも、具なしのおにぎりでも、海苔があれば何とか…

博士

海苔もないんじゃ！