VDU does receive the 'stub', which is always a document. The term
'stub' can mislead people into thinking a deleted document is not an
actual document (it is).
Here I insist that deleted documents have a reason;
➜ ~ curl localhost:5984/db1/_design/foo -XPUT -d
'{"validate_doc_update":"function(newDoc) { if(newDoc._deleted &&
!newDoc.reason) { throw({forbidden:\"must have a reason\"}); } }"}'
{"ok":true,"id":"_design/foo","rev":"1-ab8a8ecd8cf3de35ed7541facfb75029"}
An empty doc;
➜ ~ curl localhost:5984/db1/bar -XPUT -d {}
{"ok":true,"id":"bar","rev":"1-967a00dff5e02add41819138abb3284d"}
I try delete with DELETE method, which just does _id, _rev, _deleted.
➜ ~ curl 'localhost:5984/db1/bar?rev=1-967a00dff5e02add41819138abb3284d'
-XDELETE
{"error":"forbidden","reason":"must have a reason"}
Now I delete with a PUT and a reason;
➜ curl 'localhost:5984/db1/bar?rev=1-967a00dff5e02add41819138abb3284d'
-XPUT -d '{"reason":"because I said so","_deleted":true}'
{"ok":true,"id":"bar","rev":"2-6e10b3cc9ea15f6a9d81aa72aaa6e098"}
And it's really deleted;
➜ ~ curl localhost:5984/db1/bar
{"error":"not_found","reason":"deleted"}
And my reason is recorded;
➜ ~ curl 'localhost:5984/db1/bar?rev=2-6e10b3cc9ea15f6a9d81aa72aaa6e098'
{"_id":"bar","_rev":"2-6e10b3cc9ea15f6a9d81aa72aaa6e098","reason":"because
I said so","_deleted":true}
B.