made the suggested changes

Author: mridula-s109

docs/reference/elasticsearch/rest-apis/retrievers.md

@@ -41,79 +41,12 @@ The following retrievers are available:
 `text_similarity_reranker`
 :   A [retriever](#text-similarity-reranker-retriever) that enhances search results by re-ranking documents based on semantic similarity to a specified inference text, using a machine learning model.
 
+`pinned`
+:   A [retriever](#pinned-retriever) that always places specified documents at the top of the results, with the remaining hits provided by a secondary retriever.
+
 `rule`
 :   A [retriever](#rule-retriever) that applies contextual [Searching with query rules](/reference/elasticsearch/rest-apis/searching-with-query-rules.md#query-rules) to pin or exclude documents for specific queries.
 
-## Pinned Retriever [pinned-retriever]
-
-A `pinned` retriever returns top documents by always placing specific documents at the top of the results, in the order provided. This is useful for promoting certain documents for particular queries, regardless of their relevance score. The remaining results are filled by a fallback retriever.
-
-#### Parameters [pinned-retriever-parameters]
-
-`ids`
-:   (Optional, array of strings)
-
-    A list of document IDs to pin at the top of the results, in the order provided.
-
-`documents`
-:   (Optional, array of objects)
-
-    A list of objects specifying documents to pin. Each object must contain at least an `_id` field, and may also specify `_index` if pinning documents across multiple indices.
-
-`fallback`
-:   (Optional, retriever object)
-
-    A retriever to use for retrieving the remaining documents after the pinned ones.
-
-Either `ids` or `documents` must be specified.
-
-### Example using `ids` [pinned-retriever-example-ids]
-
-```console
-GET /restaurants/_search
-{
-  "retriever": {
-    "pinned": {
-      "ids": ["doc1", "doc2"],
-      "fallback": {
-        "standard": {
-          "query": {
-            "match": {
-              "title": "elasticsearch"
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-### Example using `documents` [pinned-retriever-example-documents]
-
-```console
-GET /restaurants/_search
-{
-  "retriever": {
-    "pinned": {
-      "documents": [
-        { "_id": "doc1", "_index": "my-index" },
-        { "_id": "doc2" }
-      ],
-      "fallback": {
-        "standard": {
-          "query": {
-            "match": {
-              "title": "elasticsearch"
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
 ## Standard Retriever [standard-retriever]
 
 A standard retriever returns top documents from a traditional [query](/reference/query-languages/querydsl.md).
@@ -991,7 +924,53 @@ GET movies/_search
 1. The `rule` retriever is the outermost retriever, applying rules to the search results that were previously reranked using the `rrf` retriever.
 2. The `rrf` retriever returns results from all of its sub-retrievers, and the output of the `rrf` retriever is used as input to the `rule` retriever.
 
+## Pinned Retriever [pinned-retriever]
+
+A `pinned` retriever returns top documents by always placing specific documents at the top of the results, with the remaining hits provided by a secondary retriever. This retriever offers similar functionality to the [pinned query](/reference/query-languages/query-dsl/query-dsl-pinned-query.md), but works seamlessly with other retrievers. This is useful for promoting certain documents for particular queries, regardless of their relevance score.
+
+#### Parameters [pinned-retriever-parameters]
+
+`ids`
+:   (Optional, array of strings)
+
+    A list of document IDs to pin at the top of the results, in the order provided.
+
+`documents`
+:   (Optional, array of objects)
+
+    A list of objects specifying documents to pin. Each object must contain at least an `_id` field, and may also specify `_index` if pinning documents across multiple indices.
+
+`retriever`
+:   (Optional, retriever object)
 
+    A retriever (for example a `standard` retriever or a specialized retriever such as `rrf` retriever) used to retrieve the remaining documents after the pinned ones.
+
+Either `ids` or `documents` must be specified.
+
+### Example using `documents` [pinned-retriever-example-documents]
+
+```console
+GET /restaurants/_search
+{
+  "retriever": {
+    "pinned": {
+      "documents": [
+        { "_id": "doc1", "_index": "my-index" },
+        { "_id": "doc2" }
+      ],
+      "retriever": {
+        "standard": {
+          "query": {
+            "match": {
+              "title": "elasticsearch"
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
 
 ## Common usage guidelines [retriever-common-parameters]
 
@@ -1016,6 +995,3 @@ When a retriever is specified as part of a search, the following elements are no
 * [`terminate_after`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search#request-body-search-terminate-after)
 * [`sort`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search#search-sort-param)
 * [`rescore`](/reference/elasticsearch/rest-apis/filter-search-results.md#rescore) use a [rescorer retriever](#rescorer-retriever) instead
-
-
-