15421: Elaborate a little more on what include= is useful for

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <pamstutz@veritasgenetics.com>

diff --git a/doc/api/methods/groups.html.textile.liquid b/doc/api/methods/groups.html.textile.liquid
index 4312a8b49d5a4d95741b5c6c5fe57afef19f3f46..6a7e0c7d3c4037094ad879767586667e670d2be6 100644 (file)
--- a/doc/api/methods/groups.html.textile.liquid
+++ b/doc/api/methods/groups.html.textile.liquid
@@ -44,7 +44,7 @@ h3. contents
 
 Retrieve a list of items owned by the group.  Use "recursive" to list objects within subprojects as well.
 
-When called with "include=owner_uuid" this also returns (in the @included@ field of the response) the objects (users, projects, or other groups) that own the objects returned in @items@.
+When called with "include=owner_uuid" this also returns (in the @included@ field of the response) the objects (users, projects, or other groups) that own the objects returned in @items@.  This can be used to fetch an object and the record of the parent project in a single API call.
 
 Arguments: