Slight code cleanup

api/client-server/administrative_contact.yaml

@@ -132,8 +132,7 @@ paths:
               }
       responses:
         200:
-          description: |-
+          description: The addition was successful.
-            The addition was successful.
           examples:
             application/json: {
                 "submit_url": "https://example.org/path/to/submitToken"
@@ -257,11 +256,10 @@ paths:
       responses:
         200:
           description: |-
-            An email was sent to the given address.
+            An email was sent to the given address. Note that this may be an
-            Note that this may be an email containing the validation token or
+            email containing the validation token or it may be informing the
-            it may be informing the user of an error.
+            user of an error.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: |-
@@ -316,10 +314,8 @@ paths:
                 required: ['id_server']
       responses:
         200:
-          description: |-
+          description: A SMS message was sent to the given phone number.
-            A SMS message was sent to the given phone number.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: |-

api/client-server/registration.yaml

@@ -237,11 +237,10 @@ paths:
       responses:
         200:
           description: |-
-            An email has been sent to the specified address.
+            An email has been sent to the specified address. Note that this
-            Note that this may be an email containing the validation token or it may be informing
+            may be an email containing the validation token or it may be
-            the user of an error.
+            informing the user of an error.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: The homeserver does not permit the address to be bound.
@@ -305,7 +304,6 @@ paths:
             that this may be an SMS message containing the validation token or
             it may be informing the user of an error.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: The homeserver does not permit the address to be bound.
@@ -435,7 +433,6 @@ paths:
         200:
           description: An email was sent to the given address.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: |-
@@ -506,7 +503,6 @@ paths:
         200:
           description: A SMS message was sent to the given phone number.
           schema:
-            type: object
             $ref: "definitions/sid.yaml"
         403:
           description: |-