From fbee83d5cf53ddb37ce4b54b6f12d7cbe0496038 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Tue, 10 Jul 2018 15:08:28 -0600
Subject: [PATCH 1/2] Clarify some of the properties on the search result

Fixes https://github.com/matrix-org/matrix-doc/issues/773
---
 api/client-server/search.yaml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/api/client-server/search.yaml b/api/client-server/search.yaml
index 687140b3..e28461c4 100644
--- a/api/client-server/search.yaml
+++ b/api/client-server/search.yaml
@@ -227,6 +227,9 @@ paths:
                                   description: |-
                                     The historic profile information of the
                                     users that sent the events returned.
+
+                                    The ``string`` key is the user ID for which
+                                    the profile belongs to.
                                   additionalProperties:
                                     type: object
                                     title: User Profile
@@ -260,15 +263,24 @@ paths:
                           The current state for every room in the results.
                           This is included if the request had the
                           ``include_state`` key set with a value of ``true``.
+
+                          The ``string`` key is the room ID for which the ``State
+                          Event`` array belongs to.
                         additionalProperties:
                           type: array
                           title: Room State
                           items:
+                            type: object
                             "$ref": "definitions/event-schemas/schema/core-event-schema/state_event.yaml"
                       groups:
                         type: object
                         title: Groups
-                        description: Any groups that were requested.
+                        description: |-
+                          Any groups that were requested.
+
+                          The outer ``string`` key is the group key requested (eg: ``room_id``
+                          or ``sender``). The inner ``string`` key is the grouped value (eg: 
+                          a room's ID or a user's ID).
                         additionalProperties:
                           type: object
                           title: Group Key

From b6f9e13d469718aa07c879b88136f4ec99719505 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Tue, 10 Jul 2018 15:09:53 -0600
Subject: [PATCH 2/2] Add newsfragment

---
 changelogs/client_server/newsfragments/1400.clarification | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changelogs/client_server/newsfragments/1400.clarification

diff --git a/changelogs/client_server/newsfragments/1400.clarification b/changelogs/client_server/newsfragments/1400.clarification
new file mode 100644
index 00000000..3fd29e92
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1400.clarification
@@ -0,0 +1 @@
+Clarify some of the properties on the search result