Merge pull request #1278 from matrix-org/t3chguy/search_docs

Fix two issues with /search docs

api/client-server/search.yaml

@@ -53,9 +53,7 @@ paths:
                     "keys": [
                       "content.body"
                     ],
-                    "search_term": "martians and men"
-                  }
-                },
+                    "search_term": "martians and men",
                     "order_by": "recent",
                     "groupings": {
                       "group_by": [
@@ -65,6 +63,8 @@ paths:
                       ]
                     }
                   }
+                }
+              }
             properties:
               search_categories:
                 type: object
@@ -181,6 +181,12 @@ paths:
                       count:
                         type: number
                         description: An approximate count of the total number of results found.
+                      highlights:
+                        type: array
+                        title: Highlights
+                        description: List of words which should be highlighted, useful for stemming which may change the query terms.
+                        items:
+                          type: string
                       results:
                         type: array
                         title: Results
@@ -318,6 +324,10 @@ paths:
                           }
                         }
                       },
+                      "highlights": [
+                        "martians",
+                        "men"
+                      ],
                       "next_batch": "5FdgFsd234dfgsdfFD",
                       "count": 1224,
                       "results": [

changelogs/client_server.rst

@@ -54,6 +54,8 @@ Unreleased changes
     (`#1264 <https://github.com/matrix-org/matrix-doc/pull/1264>`_).
   - Document ``/logout/all`` endpoint
     (`#1263 <https://github.com/matrix-org/matrix-doc/pull/1263>`_).
+  - Document `highlights` field in /search response
+    (`#1274 <https://github.com/matrix-org/matrix-doc/pull/1274>`_).
 
 r0.3.0
 ======