cakephp/docs — pull request #385 by dereuromark (2012-09-20 09:13:17+00:00)
Title: Model::create() clarifications

the book is too lazy about how create() should be used in user land code.
it makes beginners think one only needs create() in loops. but callbacks like beforeFilter() could at some point later in the development save sth prior to the action itself and mess up the save call.
the id would then be already set and we update a record we didnt want to be updated.
also - with the new event system the callbacks/events are not that easy to oversee. there can always be something triggered in between.

we should not encourage people to write code that can easily break in the future without knowing about it.
so create() should always be used with inserting new rows - and this should be well documented.