[GitHub] flimzy commented on a change in pull request #332: Review and update partition content.

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

flimzy commented on a change in pull request #332: Review and update partition content.
URL: https://github.com/apache/couchdb-documentation/pull/332#discussion_r221421832
 
 

 ##########
 File path: src/api/database/partitions.rst
 ##########
 @@ -76,10 +75,10 @@ such that each partition can be queried meaningfully.
 ==================================
 
 .. http:post:: /{db}/_partition/{partition}/_find
-    :synopsis: Find documents inside a specific partition
-
-    Find documents inside a specific partition, see the main
-    documentation for :ref:`_find <api/db/_find>`.
+    :synopsis: Finds documents inside the specified partition
+    
+    Finds documents inside the specified partition. See the CouchDB
+    documentation for more information about :ref:`_find <api/db/_find>`.
 
 Review comment:
   "See the CouchDB documentation" from within the CouchDB documentation seems possibly confusing to me. Maybe we can re-word this, to something like:
   
   > For more information, see :ref:`_find <api/db/_find>`.
   
   ?

----------------------------------------------------------------
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