From 784adade9bc0332359d815036c53722aed82e3b4 Mon Sep 17 00:00:00 2001
From: Michael Telatynski <7t3chguy@gmail.com>
Date: Thu, 21 Dec 2017 17:45:26 +0000
Subject: [PATCH] changes based on Pull Request feedback

---
 api/client-server/users.yaml        | 8 ++++----
 specification/client_server_api.rst | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/api/client-server/users.yaml b/api/client-server/users.yaml
index cecf9424..1734e3bb 100644
--- a/api/client-server/users.yaml
+++ b/api/client-server/users.yaml
@@ -32,8 +32,8 @@ paths:
       summary: Searches the user directory.
       description: |-
         This API performs a server-side search over all users registered on the server.
-        Searches MXID and displayname case-insesitively for users that you share a room with or that are in public rooms.
-      operationId: postUserDirectorySearch
+        It searches user ID and displayname case-insensitively for users that you share a room with or that are in public rooms.
+      operationId: searchUserDirectory
       security:
         - accessToken: []
       parameters:
@@ -48,7 +48,7 @@ paths:
                 example: "foo"
               limit:
                 type: number
-                description: The maximum number of results to return (10 if omitted), with a maximum of 50
+                description: The maximum number of results to return (Defaults to 10).
                 example: 10
             required: ["search_term"]
       responses:
@@ -80,7 +80,7 @@ paths:
                     user_id:
                       type: string
                       example: "@foo:bar.com"
-                      description: The MXID of the user.
+                      description: The user's matrix user ID.
                     display_name:
                       type: string
                       example: "Foo"
diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst
index e40aa6f1..326ff282 100644
--- a/specification/client_server_api.rst
+++ b/specification/client_server_api.rst
@@ -1351,7 +1351,7 @@ Profiles
 {{profile_cs_http_api}}
 
 Events on Change of Profile Information
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
++++++++++++++++++++++++++++++++++++++++
 Because the profile display name and avatar information are likely to be used in
 many places of a client's display, changes to these fields cause an automatic
 propagation event to occur, informing likely-interested parties of the new