как по мне многие проблемы с разработчиками из-за чрезмерно упрощенной документации... оно как бы хорошо с одной стороны, с другойстороны многие слишком буквально воспринимают упрощенные примеры.
Я не утверждал, что она идеальна. На форумах уже сколько топиков исписано, что нельзя в доке показывать activeRecordот греха подальше;)