For request operations at PUT and DELETE endpoints rev parameter is obligatory, which isn’t stated in docs.
The docs seem accurate
Revision Id is not mandatory for PUT requests when it is used to create the document.
Revision Id is mandatory for DELETE requests and is indicated as such in the documentation
Please share the link to the docs that you are referring to where the above isn’t indicated. (This is also a general comment while raising documentation related issues in future).
Sorry, my fault - it’s query (_design / view) ones.
Here is the link
Please click the “Feedback on this page” button at the bottom of the doc page and enter your issue there. That will convey it to the docs team.
Thank you for your suggestion.