[GitHub] flimzy commented on a change in pull request #241: Add statement for multiple queris for _all_docs

[GitBox <gi...@apache.org>]

flimzy commented on a change in pull request #241: Add statement for multiple queris for _all_docs
URL: https://github.com/apache/couchdb-documentation/pull/241#discussion_r163768469
 
 

 ##########
 File path: src/api/database/bulk-api.rst
 ##########
 @@ -147,6 +147,139 @@
             "offset" : 0
         }
 
+Sending multiple queries to a database
+======================================
+
+.. versionadded:: 2.1+
+
+.. http:post:: /{db}/_all_docs
+    :synopsis: Returns results for the specified queries
+
+    Executes multiple specified built-in view queries of all documents in this
+    database. This enables you to request multiple documents in a single
 
 Review comment:
   I wonder if it would be worth explaining in more detail that (as I understand) this allows combining the results of _multiple queries_, not just _multiple documents_ (`_all_docs` already returns multiple documents, so I can see room for confusion, upon a cursory read of this statement).  Perhaps something like:
   
   > This enables you to request the results of multiple queries in a single request, in place of ...

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services