Fix allowed method for ddoc update function
The semantics of PUT [1] are arguably incorrect for executing an
update function on a specified document, since nothing is being
created or updated. Also it's not clear why it would be different from
the POST used for executing an update function for `null` document. [2]
Additionally, the example code-block in this section uses POST:
POST /recipes/_design/recipe/_update/ingredients/SpaghettiWithMeatballs HTTP/1.1
All which lead me to believe that the PUT is a typo.
The actual behavior of CouchDB doesn't help here, since it currently
accepts any method whatsoever:
$ curl -v -u adm localhost:15984/db-1/_design/ddoc/_update/change -X BOGUS
> BOGUS /db-1/_design/bar/_update/change HTTP/1.1
>
< HTTP/1.1 200 OK
< content-length: 11
< content-type: text/html; charset=utf-8
<
* Connection #0 to host localhost left intact
Empty World* Closing connection 0
[1] https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
[2] https://docs.couchdb.org/en/latest/api/ddoc/render.html#post--db-_design-ddoc-_update-func
This repository contains the Sphinx source for Apache CouchDB's documentation. You can view the latest rendered build of this content at:
http://docs.couchdb.org/en/latest
Install Python3 and pip. Then:
$ python3 -m venv .venv $ source .venv/bin/activate $ pip install -r requirements.txt $ make html # builds the docs $ make check # syntax checks the docs
General feedback is welcome at our user or developer mailing lists.
Apache CouchDB has a CONTRIBUTING file with details on how to get started with issue reporting or contributing to the upkeep of this project.