diff --git a/api/server-server/definitions/event-schemas/m.direct_to_device.yaml b/api/server-server/definitions/event-schemas/m.direct_to_device.yaml
index 48cdc4ed7..12578f4da 100644
--- a/api/server-server/definitions/event-schemas/m.direct_to_device.yaml
+++ b/api/server-server/definitions/event-schemas/m.direct_to_device.yaml
@@ -25,24 +25,24 @@ allOf:
       edu_type:
         type: enum
         enum: ['m.direct_to_device']
-        description: The string ``m.direct_to_device``
+        description: The string ``m.direct_to_device``.
         example: "m.direct_to_device"
       content:
         type: object
-        description: The description of the direct-to-device message
+        description: The description of the direct-to-device message.
         title: To Device Message
         properties:
           sender:
             type: string
-            description: user ID of the sender
+            description: User ID of the sender.
             example: "john@example.com"
           type:
             type: string
-            description: event type for the message
+            description: Event type for the message.
             example: "m.room_key_request"
           message_id:
             type: string
-            description: unique ID for the message, used for idempotence.  Arbitrary
+            description: Unique ID for the message, used for idempotence.  Arbitrary
               utf8 string, of maximum length 32 codepoints.
             example: "hiezohf6Hoo7kaev"
           messages:
diff --git a/specification/server_server_api.rst b/specification/server_server_api.rst
index b423a83e0..5203c5e03 100644
--- a/specification/server_server_api.rst
+++ b/specification/server_server_api.rst
@@ -1022,6 +1022,7 @@ the following EDU:
 
 {{definition_ss_event_schemas_m_direct_to_device}}
 
+
 Content Repository
 ------------------