DOC-8186 Java FTS SDK Results Cap #478

Merge pull request  from couchbase/DOC-8186_JAVA_FTS_SDK_Results_Cap

Author: simon-dew

modules/howtos/pages/full-text-searching-with-sdk.adoc

@@ -1,17 +1,17 @@
 = Search
-:description: You can use the Full Text Search service (FTS) to create queryable full-text indexes in Couchbase Server.
+:description: You can use the Search Service to create queryable full-text indexes in Couchbase Server.
 :page-toclevels: 2
 :page-aliases: ROOT:search-query.adoc, ROOT:full-text-searching-with-sdk.adoc
 
 [abstract]
 {description}
 
-Full Text Search or FTS allows you to create, manage and query full text indexes on JSON documents stored in Couchbase buckets.
+The Search Service allows you to create, manage and query full-text indexes on JSON documents stored in Couchbase buckets.
 It uses natural language processing for indexing and querying documents, provides relevance scoring on the results of your queries and has fast indexes for querying a wide range of possible text searches.
 
 Some of the supported query-types include simple queries like Match and Term queries, range queries like Date Range and Numeric Range and compound queries for conjunctions, disjunctions and/or boolean queries.
 
-The Full Text Search service also supports vector search from Couchbase Server 7.6 onwards.
+The Search Service also supports vector search from Couchbase Server 7.6 onwards.
 
 == Getting Started
 
@@ -31,7 +31,7 @@ include::devguide:example$java/Search.java[tag=simple,indent=0]
 ----
 
 Let's break it down. 
-The `searchQuery` API takes the name of the index and the type of query  as required arguments and then allows to provide additional options if needed
+The `searchQuery` API takes the name of the index and the type of query as required arguments and then allows to provide additional options if needed
 (in the example above, no options are specified).
 
 Once a result returns you can iterate over the returned rows, and/or access the `SearchMetaData` associated with the query. 
@@ -42,6 +42,17 @@ If something goes wrong during the execution of the search query, a subclass of
 Exception in thread "main" com.couchbase.client.core.error.IndexNotFoundException: Index not found {"completed":true,"coreId":1,"httpStatus":400,"idempotent":true,"lastDispatchedFrom":"127.0.0.1:53818","lastDispatchedTo":"127.0.0.1:8094","requestId":3,"requestType":"SearchRequest","service":{"indexName":"unknown-index","type":"search"},"status":"INVALID_ARGS","timeoutMs":75000,"timings":{"dispatchMicros":18289,"totalMicros":1359398}}
 ----
 
+[TIP]
+.Search Results Limit
+====
+By default, the Search Service returns only the first 10 matches (`size: 10`, `from: 0`).
+To retrieve more results, you must explicitly define pagination settings such as `size` or `from` in your query.
+
+For information about formatting your Search query and specifying limits, see xref:server:search:search-request-params.adoc[].
+
+For information about pagination in Search responses, see xref:server:fts:fts-search-response.adoc#pagination[Pagination].
+====
+
 == Search Queries
 
 The second mandatory argument in the example above used `SearchQuery.queryString("query")` to specify the query to run against the search index. 

preview/HEAD.yml

@@ -0,0 +1,5 @@
+sources:
+  docs-server:
+    branches: release/8.0
+  docs-devex:
+    branches: release/8.0