some clarification on model docs