俺のお気に入りのパラダイムなら
ドキュメントは関数に紐づくだけだね

このクラスには
このメソッドがあります、
このメソッドは、何々インターフェースを実装しています
このメソッドはObjectクラスから継承されたものです
このクラスにおいては型制約を満たした型パラメータしか入力できません
このメソッドはオーバーロードされます(同じ名前のメソッドがずらずら)

これがクラスの個数だけ繰り返されると
まずドキュメントからしてDRY原則が崩壊してることぐらいわかるよな
自分の欲しい機能だけを簡単に切り出すことができないし、クラスの数だけ同じ文面がくり返される

僕らならこんなことはしない
関数はこんなに恩着せがましくもばければ、クラスを使う度にいらないメソッドを押し売りなんてしない

試しにmsdnでdictionaryクラスのドキュメントでもみてきたらどうだ

正確にはSystem.Collections.generic.Dictionary <TKey,TValue>クラスな

こんだけ長いドキュメントを読み込んで、ようやく使えるこれ

javascriptなら{}って書くだけで使えるんだが