Omision from the documentation for Model Instances page
|Reported by:||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
I discovered a surprising omission from the docs today:
The following paragraph suggests that delete() would have been documented above it, but only save() is.
Extra instance methods
In addition to save(), delete(), a model object might get any or all of the following methods:
I may be looking in the wrong place but I couldn't find any documentation for the delete() function for model instances in the docs. While it's fairly self explainitory and I've pretty much been able to figure out the answer to my question through experimetation (whether delete() is instant or requires a call to save() to make the change in the DB).
I say this was a suprising ommision because Django's docs are about the best I have used for any bit of software.