diff --git a/data/api/client-server/room_initial_sync.yaml b/data/api/client-server/room_initial_sync.yaml
index c02a8ae9..130efa1c 100644
--- a/data/api/client-server/room_initial_sync.yaml
+++ b/data/api/client-server/room_initial_sync.yaml
@@ -7,10 +7,10 @@ paths:
     get:
       summary: Snapshot the current state of a room and its most recent messages.
       description: |-
-        This api should now exclusively be used for "peeking" into viewable rooms you're not a member of ([Room Previews](/client-server-api/#room-previews))
-
         Get a copy of the current state and the most recent messages in a room.
 
+        This endpoint should now exclusively be used for "peeking" into viewable rooms
+        you're not a member of ([Room Previews](/client-server-api/#room-previews)).
         Using this endpoint for something other than peeking was deprecated in r0 of this specification.
         The relevant information for syncing is now returned by the
         [`/sync`](/client-server-api/#get_matrixclientv3sync) API. See the