updated specs and docs for the activerecord.models scope