Improve document search doc (#678)

Author: Aschen

doc/7/controllers/document/search/index.md

@@ -12,28 +12,21 @@ Searches documents.
 There is a limit to how many documents can be returned by a single search query.
 That limit is by default set at 10000 documents, and you can't get over it even with the from and size pagination options.
 
+Once a `SearchResult` has been retrieved, navigation through pages can be done with the [SearchResult.next](/sdk/js/7/core-classes/search-result/next) method.
+
 :::info
 When processing a large number of documents (i.e. more than 1000), it is advised to paginate the results using [SearchResult.next](/sdk/js/7/core-classes/search-result/next) rather than increasing the size parameter.
 :::
 
 ::: warning
-When using a cursor with the `scroll` option, Elasticsearch has to duplicate the transaction log to keep the same result during the entire scroll session.  
-It can lead to memory leaks if a scroll duration too great is provided, or if too many scroll sessions are open simultaneously.  
-:::
-
-::: info
-<SinceBadge version="Kuzzle 2.2.0"/>
-You can restrict the scroll session maximum duration under the `services.storage.maxScrollDuration` configuration key.
+When using a cursor with the `scroll` option, Elasticsearch duplicates the transaction log to keep the same result during the entire scroll session.
+It can lead to memory leaks if a scroll duration too great is provided, or if too many scroll sessions are open simultaneously.
 :::
 
 <SinceBadge version="7.4.8"/>
 
-This method also supports the [Koncorde Filters DSL](/core/2/api/koncorde-filters-syntax) to match documents by passing the `lang` argument with the value `koncorde`.  
-Koncorde filters will be translated into an Elasticsearch query.  
-
-::: warning
-Koncorde `bool` operator and `regexp` clause are not supported for search queries.
-:::
+This method also supports the [Koncorde Filters DSL](/core/2/api/koncorde-filters-syntax) to match documents by passing the `lang` argument with the value `koncorde`.
+Koncorde filters will be translated into an Elasticsearch query.
 
 <br/>
 
@@ -79,14 +72,38 @@ An empty body matches all documents in the queried collection.
 
 ## Resolves
 
-Resolves to a [SearchResult](/sdk/js/7/core-classes/search-result) object.
+Resolves to a [SearchResult](/sdk/js/7/core-classes/search-result/properties) object.
 
 ## Usage
 
 With the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/7.4/query-dsl.html) syntax.
 
+<details><summary>Show snippet</summary>
+
 <<< ./snippets/search-es.js
 
+</details>
+
 With the [Koncorde Filters DSL](/core/2/api/koncorde-filters-syntax) syntax.
 
+<details><summary>Show snippet</summary>
+
 <<< ./snippets/search-koncorde.js
+
+</details>
+
+Pagination with [SearchResult.next](/sdk/js/7/core-classes/search-result/next)
+
+<details><summary>Show snippet</summary>
+
+```js
+let result = await sdk.document.search('nyc-open-data', 'yellow-taxi', {}, { scroll: '2s' });
+
+while (result) {
+  // process result.hits here
+
+  result = await result.next();
+}
+```
+
+</details>

doc/7/essentials/realtime-application/index.md

@@ -29,7 +29,7 @@ They are automatically connected to the realtime engine, and their content (`_so
 
 You can therefor directly use them as props for your frontend components for example.
 
-::: warn
+::: warning
 There is a limit on how many realtime documents a single observer instance can manage. This limit is set by collection and by default it's 100 documents per collection. You can increase this limit in Kuzzle configuration under the `limits.subscriptionConditionsCount` key.
 :::