オーバーロード
そうそう、Ruby や Perl のメソッドで困るのは、どっちかというと暗黙のオーバーロード(?)かも。引数が *args とかで臨機応変に動くやつ。これはソース読むとき、条件分岐を頭に入れながら読むのが大変。
ActiveRecord::Base#find とかドキュメントがちゃんとしてるのは良いんだけど、Perl の Class::DBI has_many は細かい動作わからなくて困りました。普通に使う分はドキュメントにあったんですけど。
あと、そんな使い方があったのか!ってこともありますね。