matrix-spec/event-schemas/schema
Travis Ralston 45c68e323a Add general clarity to the /createRoom endpoint
This commit does a number of things:
* Minor formatting/alignment changes
* Document the room_alias response key. This could be deprecated now, or forfeited, if needed.
* Remove the guest_can_join parameter - it is not actually supported
* Document the previously undocumented power_level_content_override parameter
* Clarify that the room_id is required on the response
* More clearly spell out which events are created as part of the request
* Clarify how the room alias becomes the canonical alias
* Clarify how the `visibility` may be used to determine a default preset to apply
* Document the `m.federate` creation content parameter, adding an option for the homeserver to define a default value

References:
* Preset being inferred by the visibility: cd32c19a60/synapse/handlers/room.py (L172-L177)
* Power level content overrides:
  * https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L198
  * https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L335-L359
* Aliases becoming canonical: https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L366-L370
* `m.federate` landing in the create event: https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L311-L315

Fixes https://github.com/matrix-org/matrix-doc/issues/1243
Fixes https://github.com/matrix-org/matrix-doc/issues/1471
Inspired by https://github.com/matrix-org/matrix-doc/issues/1213
2018-08-15 17:25:30 -06:00
..
core-event-schema Sticker messages (m.sticker) (#1158) 2018-03-27 10:00:41 +01:00
m.call.answer Make all the schema files yaml 2015-12-07 13:56:36 +00:00
m.call.candidates Make all the schema files yaml 2015-12-07 13:56:36 +00:00
m.call.hangup Make all the schema files yaml 2015-12-07 13:56:36 +00:00
m.call.invite Make all the schema files yaml 2015-12-07 13:56:36 +00:00
m.direct Better types for additionalProps 2016-10-14 15:57:52 +01:00
m.ignored_user_list Add clarity to the m.ignored_user_list 2018-03-06 10:32:18 -07:00
m.presence Make m.presence match what synapse returns 2018-03-03 12:12:47 -07:00
m.receipt Add event as a parent for all event types 2016-03-16 16:46:16 +01:00
m.room.aliases Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.avatar Make the key orders consistent 2016-11-07 14:54:59 +00:00
m.room.canonical_alias Make null m.room.name behaviour explicit 2016-07-12 13:44:04 +01:00
m.room.create Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.guest_access Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.history_visibility Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.join_rules Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.member More PR feedback 2016-10-05 12:59:49 +01:00
m.room.message Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.message#m.audio Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.message#m.emote Document message formats as-is 2018-07-10 12:52:11 -06:00
m.room.message#m.file Make the key orders consistent 2016-11-07 14:54:59 +00:00
m.room.message#m.image Make the key orders consistent 2016-11-07 14:54:59 +00:00
m.room.message#m.location Make the key orders consistent 2016-11-07 14:54:59 +00:00
m.room.message#m.notice Make m.notice description use stricter language 2016-11-30 00:59:51 +01:00
m.room.message#m.text Document message formats as-is 2018-07-10 12:52:11 -06:00
m.room.message#m.video Make the key orders consistent 2016-11-07 14:54:59 +00:00
m.room.message.feedback Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.name Make null m.room.name behaviour explicit 2016-07-12 13:44:04 +01:00
m.room.pinned_events Add spec for m.room.pinned_events 2017-09-29 11:59:27 -06:00
m.room.power_levels Add general clarity to the /createRoom endpoint 2018-08-15 17:25:30 -06:00
m.room.redaction Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.third_party_invite Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.room.topic Convert event schemas to yaml 2016-06-22 12:01:08 +01:00
m.sticker Sticker messages (m.sticker) (#1158) 2018-03-27 10:00:41 +01:00
m.tag Add event as a parent for all event types 2016-03-16 16:46:16 +01:00
m.typing Add event as a parent for all event types 2016-03-16 16:46:16 +01:00