From d528ff684b6cd625852f68fd287adc53ea952853 Mon Sep 17 00:00:00 2001
From: Johannes Marbach <n0-0ne+github@mailbox.org>
Date: Fri, 28 Jun 2024 14:14:32 +0200
Subject: [PATCH] Fix minor typos in third-party networks module (#1892)

---
 changelogs/client_server/newsfragments/1892.clarification | 1 +
 data/api/application-service/definitions/protocol.yaml    | 8 ++++----
 data/api/application-service/definitions/user.yaml        | 2 +-
 data/api/client-server/third_party_lookup.yaml            | 4 ++--
 4 files changed, 8 insertions(+), 7 deletions(-)
 create mode 100644 changelogs/client_server/newsfragments/1892.clarification

diff --git a/changelogs/client_server/newsfragments/1892.clarification b/changelogs/client_server/newsfragments/1892.clarification
new file mode 100644
index 00000000..3ccb2333
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1892.clarification
@@ -0,0 +1 @@
+Fix various typos throughout the specification.
diff --git a/data/api/application-service/definitions/protocol.yaml b/data/api/application-service/definitions/protocol.yaml
index c442a1b1..ff6300db 100644
--- a/data/api/application-service/definitions/protocol.yaml
+++ b/data/api/application-service/definitions/protocol.yaml
@@ -42,9 +42,9 @@ properties:
     example: "mxc://example.org/aBcDeFgH"
   field_types:
     description: |-
-      The type definitions for the fields defined in the `user_fields` and
-      `location_fields`. Each entry in those arrays MUST have an entry here. The
-      `string` key for this object is field name itself.
+      The type definitions for the fields defined in `user_fields` and
+      `location_fields`. Each entry in those arrays MUST have an entry here.
+      The `string` key for this object is the field name itself.
 
       May be an empty object if no fields are defined.
     type: object
@@ -60,7 +60,7 @@ properties:
             may apply additional validation or filtering.
           type: string
         placeholder:
-          description: An placeholder serving as a valid example of the field value.
+          description: A placeholder serving as a valid example of the field value.
           type: string
       required: ['regexp', 'placeholder']
     example: {
diff --git a/data/api/application-service/definitions/user.yaml b/data/api/application-service/definitions/user.yaml
index 3178b56d..62cac033 100644
--- a/data/api/application-service/definitions/user.yaml
+++ b/data/api/application-service/definitions/user.yaml
@@ -15,7 +15,7 @@
 # TODO: Change userid to user_id as a breaking change
 properties:
   userid:
-    description: A Matrix User ID represting a third-party user.
+    description: A Matrix User ID representing a third-party user.
     type: string
     example: "@_gitter_jim:matrix.org"
   protocol:
diff --git a/data/api/client-server/third_party_lookup.yaml b/data/api/client-server/third_party_lookup.yaml
index 1abcb771..97547a6f 100644
--- a/data/api/client-server/third_party_lookup.yaml
+++ b/data/api/client-server/third_party_lookup.yaml
@@ -158,7 +158,7 @@ paths:
               schema:
                 $ref: ../application-service/definitions/user_batch.yaml
         "404":
-          description: The Matrix User ID was not found
+          description: The Matrix User ID was not found.
           content:
             application/json:
               schema:
@@ -232,7 +232,7 @@ paths:
               schema:
                 $ref: ../application-service/definitions/user_batch.yaml
         "404":
-          description: The Matrix User ID was not found
+          description: The Matrix User ID was not found.
           content:
             application/json:
               schema: