Clarify wording in the /join endpoints summaries and descriptions

This commit is contained in:
Kim Brose 2024-12-17 23:38:09 +00:00 committed by GitHub
parent 921c6becf1
commit aff007ccaa
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -18,12 +18,12 @@ info:
paths:
"/rooms/{roomId}/join":
post:
summary: Start the requesting user participating in a particular room.
summary: Join the requesting user to a particular room.
description: |-
*Note that this API requires a room ID, not alias.*
`/join/{roomIdOrAlias}` *exists if you have a room alias.*
This API starts a user participating in a particular room, if that user
This API starts a user's participation in a particular room, if that user
is allowed to participate in that room. After this call, the client is
allowed to see all current state events in the room, and all subsequent
events associated with the room until the user leaves the room.
@ -113,11 +113,11 @@ paths:
- Room membership
"/join/{roomIdOrAlias}":
post:
summary: Start the requesting user participating in a particular room.
summary: Join the requesting user to a particular room.
description: |-
*Note that this API takes either a room ID or alias, unlike* `/rooms/{roomId}/join`.
This API starts a user participating in a particular room, if that user
This API starts a user'S participation in a particular room, if that user
is allowed to participate in that room. After this call, the client is
allowed to see all current state events in the room, and all subsequent
events associated with the room until the user leaves the room.