書ける書けないの問題じゃなくて、
メソッドリファレンスだけ用意してドキュメント完備したつもりになってるのはダメ、
って話なのでは。
概要など README 的なものとかチュートリアルとか tips とか FAQ とかも重要なわけで。