435 Commits (b26aa7fcf541a4e23ac5c8a16b8d609c8c63b005)

Author	SHA1	Message	Date
Andrew Morgan	b26aa7fcf5	Remove 'room_id' field from `m.typing`, `m.receipt` and `m.fully_read` examples and schema (#3679) ... The spec had an erroneous `room_id` field in a m.typing EDU entry of /sync, `m.read` receipts in `/sync`, and `m.fully_read` room account data objects in the spec. None of these are necessary nor used in practice. Checking part of the ecosystem for whether clients look for, or homeservers include, these room_id fields, I found that: Element does not require them, nor does Synapse include them. Ruma does not include them. Dendrite does not include them. nheko/mtxclient does not look for them. This change removes room_id from the example and OpenAPI schema in each case mentioned above. It only affects the Client-Server spec - the Server-Server spec text remains unchanged. The field was initially introduced in 0f28f83.	2 years ago
Aaron Raimist	2e63733beb	Remove unenforced size limit on room names (#3669) ... Fixes #3641 The spec says the name field in m.room.name events must not exceed 255 bytes but no servers actually enforce this over the C-S API. Clients should probably already be truncating room names to an appropriate length for their user interface. Signed-off-by: Aaron Raimist <aaron@raim.ist>	2 years ago
Jonas Platte	d7d52e8074	Fix broken link in end_to_end_encryption.md (#3708)	2 years ago
Travis Ralston	7afac76e18	Fix membership state table and diagram (#3730) ... * Fix membership state table and diagram There were 2 missing cases which are legal: * `invite->knock` (a fairly silly thing to do, but legal under the auth rules) * `external->leave (via /kick)` (another somewhat silly thing to do, but no different than `external->ban (via /ban)`) The state table considered the first as illegal, which is untrue. * Changelog * Make the graph prettier * Update changelogs/client_server/newsfragments/3730.clarification Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>	2 years ago
Travis Ralston	8851974d03	Another changelog fix (#3731)	2 years ago
Travis Ralston	7aeea64797	Fix location of some changelogs (#3728) ... They were seemingly put in the wrong place. They are only on unstable and do not affect a release.	2 years ago
Hubert Chathi	d06f05571f	move changelog to the right place	2 years ago
Travis Ralston	e488a7fb6d	v1.2 changelog	2 years ago
Richard van der Hoff	36b02edfc2	Distinguish 'client' from 'federation' events (#3658) ... Fixes #3305 Fixes #3380 The idea here is to better distinguish between a 'raw' event (as we send over the wire), and the 'serialised' format, as sent in responses to the C-S api and in `PUT /_matrix/app/v1/transactions/{txnId}`. It's made more complicated by the fact that there are _two_ serialisation formats, one used by `/sync` and `/notifications`, and one by everything else (the difference being whether `room_id` is included). In an ideal world, we wouldn't repeat `SerialisedEvent` every time it's used, and instead just link to the first reference, but that's a job for another day. Another job for another day is to get rid of things like `sync_state_event.yaml` (which is now used only in one place, so should be inlined.)	2 years ago
Aaron Raimist	990dfec94b	Update several spots where C-S API was still using r0 APIs (#3671) ... * Update several spots where C-S API was still using r0 APIs Signed-off-by: Aaron Raimist <aaron@raim.ist> * Add changelog Signed-off-by: Aaron Raimist <aaron@raim.ist>	2 years ago
Alexandre Franke	d3e39567f4	Responses schema fixes (#3650) ... Fixes #2237. Corrects the response schemas for: ``` PUT /user/{user_id}/account_data/{account_dataType} PUT /user/{user_id}/rooms/{roomId}/account_data/{type} PUT /directory/list/room/{roomId} PUT /sendToDevice/{eventType}/{txnId} POST /account/3pid POST /account/3pid/add POST /account/3pid/bind ```	2 years ago
Travis Ralston	df1d150142	Add missing changelog	2 years ago
Richard van der Hoff	4a9c236572	Changelogs for #3674	2 years ago
Travis Ralston	6c4aabd053	Room versions 8 and 9: Restricted rooms (#3387) ... * Room versions 8 and 9: Restricted rooms MSCs: * https://github.com/matrix-org/matrix-doc/pull/3083 * https://github.com/matrix-org/matrix-doc/pull/3289 * https://github.com/matrix-org/matrix-doc/pull/3375 * Changelogs * Capitalization Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com> * Remove verbiage for spaces because they don't exist * Iterations on text * Another clarification * Make error code descriptions consistent * Apply suggestions from code review Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * Incorporate from merge * Misc language update per review * Update accuracy before splitting auth rules * fix wtf moment * Fix up v8 and v9 to match "fully specify room versions" * Scope auth events selection to room version * Apply consistency * Add changelogs * Review part 1 * Apply suggestions from code review Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * Split out redaction sections * Clarify general case of join conditions Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com> Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>	2 years ago
Travis Ralston	3475ef62ab	Remove straggling case of "groups" (#3652) ... * Remove straggling case of "groups" * changelog	2 years ago
Travis Ralston	fc3f7d60eb	Remove `aliases` from `/publicRooms` response (#3624) ... Through attempting to land [Synapse#11667](https://github.com/matrix-org/synapse/pull/11667) it was found that Synapse doesn't return the `aliases` property on `/publicRooms` as it was [removed](https://github.com/matrix-org/synapse/pull/6970) by a [tracking issue](https://github.com/matrix-org/synapse/issues/6898) referencing [MSC2432](https://github.com/matrix-org/matrix-doc/pull/2432) as its base. Though MSC2432 does not make mention of this, the [document](https://docs.google.com/document/d/1NNDkobiFLeUkJtyj0H6qvKIedgvIkZnFKo78-03cGEk/edit) the MSC is based upon makes deliberate effort to mention the endpoint and the removal of `aliases`. Thus, it is determined as a likely accidental omission from the formal MSC and therefore the formal spec. This has been corrected here by amending the MSC (per the process) and removing the field, basing itself off of the [spec PR for spaces](https://github.com/matrix-org/matrix-doc/pull/3610) for diff clarity.	2 years ago
Travis Ralston	9af83dfd41	Add Spaces to the spec (#3610) ... * First iteration of specifying Spaces MSCs: * https://github.com/matrix-org/matrix-doc/pull/3288 * https://github.com/matrix-org/matrix-doc/pull/2946 * https://github.com/matrix-org/matrix-doc/pull/1772 Note that this makes modifications to the underlying MSCs as well. These are intended to be minor edits to aid clarity/accuracy of the MSCs, as per the proposal process. Functionally, clients and servers might need to change their behaviour slightly as is expected of implementing this stuff early. Synapse has these changes (alongside backwards compatibility) here: https://github.com/matrix-org/synapse/pull/11667 * add changelogs * Accuracy per review * Apply suggestions from code review Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * fully prefix new endpoints * Fully prefix endpoint in 3616 too * Fix ordering example Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>	2 years ago
Hubert Chathi	6fb684397a	Clarify how to interpret missing one time key counts (#3636)	2 years ago
Travis Ralston	56532dd688	Describe and hoist stripped state to a first-class citizen (#3606) ... * Describe and hoist stripped state to a first-class citizen Fixes https://github.com/matrix-org/matrix-doc/issues/3413 MSC: https://github.com/matrix-org/matrix-doc/pull/3173 * Add changelog * may->can for clarity * Update text per review	2 years ago
Travis Ralston	224773dc6a	Specify fallback keys (#3615) ... * Specify fallback keys MSC: https://github.com/matrix-org/matrix-doc/pull/2732 * changelog * Appease spell check * Fine, let's appease the spellcheck this way * Apply suggestions from code review Co-authored-by: Hubert Chathi <hubert@uhoreg.ca> * Fix intro * word wrap Co-authored-by: Hubert Chathi <hubert@uhoreg.ca>	2 years ago
Travis Ralston	26e0765159	Add guest changes to spec: MSC3069 and MSC3419 (#3605) ... * Add MSC3069 support https://github.com/matrix-org/matrix-doc/pull/3069 * Add MSC3419 support https://github.com/matrix-org/matrix-doc/pull/3419 * Normalize and fix guest access endpoints list * Changelogs	2 years ago
Travis Ralston	0ee58100c4	Add capabilities described by MSC3283 (#3614) ... * Add capabilities described by MSC3283 MSC: https://github.com/matrix-org/matrix-doc/pull/3283 * changelog	2 years ago
Travis Ralston	e4057072bd	Add registration token UIA type (#3616) ... * Add registration token UIA type MSC: https://github.com/matrix-org/matrix-doc/pull/3231 **Note**: This introduces the endpoint as v1 rather than r0 given the global versioning changes landed between the acceptance of the MSC and now. * Fix swagger * Changelogs * Update data/api/client-server/registration_tokens.yaml Co-authored-by: Hubert Chathi <hubert@uhoreg.ca> Co-authored-by: Hubert Chathi <hubert@uhoreg.ca>	2 years ago
Travis Ralston	1e9dd4d22e	Avoid use of the word "clobber" (#3611) ... * Avoid use of the word "clobber" Fixes https://github.com/matrix-org/matrix-doc/issues/1328 * changelog	2 years ago
Dan Callahan	48d8f7202d	Add HTTP 403 to possible profile responses (#3530) ... * Add HTTP 403 to possible profile responses Some servers may not allow profile lookup over federation, and thus respond to GET /_matrix/client/v3/profile/{userId} with an HTTP 403. For example, Synapse can be configured to behave in this way by setting: allow_profile_lookup_over_federation=false Thus, this behavior already exists in the wild, and may cause issues for clients such as https://github.com/vector-im/element-web/issues/17269. Synapse could alter its behavior and return an HTTP 404 in these cases, but amending the Spec seems preferable to align with extant behavior. Further, allowing HTTP 403 gives clients more specific information as to why a request has failed, enabling more precise error handling. Signed-off-by: Dan Callahan <danc@element.io> * Update changelogs/client_server/newsfragments/3530.clarification Co-authored-by: Travis Ralston <travpc@gmail.com> * Annotate misc data about error Co-authored-by: Travis Ralston <travpc@gmail.com> Co-authored-by: Travis Ralston <travisr@matrix.org>	2 years ago
Will Hunt	a05706780d	Add m.login.appservice to the spec (#3324) ... Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> Co-authored-by: Hubert Chathi <hubertc@matrix.org> Co-authored-by: Travis Ralston <travisr@matrix.org>	2 years ago
Travis Ralston	00ee4d7010	Add changelog	2 years ago
Aaron Raimist	01cd41de68	Add GitHub Action to check spelling (#3591) ... Signed-off-by: Aaron Raimist <aaron@raim.ist>	2 years ago
Travis Ralston	d2fd90579b	Add changelog	2 years ago
Shay	87fcb7c8b0	Clarify that `base_url` in client `well_known` may or may not include trailing slash (#3562) ... Fixes #3465. The change adds a line explicitly warning developers that the base_url of client well_known may or may not include a trailing slash and to be prepared to handle both cases.	2 years ago
Hubert Chathi	71988263f3	clarify which signature to check (#3573)	2 years ago
Richard van der Hoff	7f200c53e8	Move `prev_content` to unsigned (#3524)	3 years ago
David Robertson	1e12b45f97	Clarifications to /sync description (#3534) ... * Clarify that E0 and E1 are not returned * Clarify that ASCII art diagram 2 refers to diagram 1 * Correct third ASCII art diagram To match the spacing in. Borked in the move to new docs format. 55aed1d296/specification/client_server_api.rst (L1610-L1615) * Make ASCII art 3 follow from ASCII art 2 * Explain how to fill the gap * Create 3543.clarification * Update content/client-server-api/_index.md Co-authored-by: Travis Ralston <travisr@matrix.org>	3 years ago
Alexandre Franke	a26f2f8ca9	Fix typo (#3535) ... * Fix typo * Add changelog Co-authored-by: Alexandre Franke <alexandre.franke@matrix.org>	3 years ago
Ankur	ac98c8c08c	OpenAPI: Add missing `required` flag in `getRoomKeys` (#3509)	3 years ago
Will Hunt	51d8560da9	Explicitly link to geo URI spec (#3492) ... * Explicitly link to geo URI spec * move RFC location Co-authored-by: Travis Ralston <travisr@matrix.org> * Create 3492.clarification Co-authored-by: Travis Ralston <travisr@matrix.org>	3 years ago
Ankur	a034d45e45	typos: Corrected typos in message_pagination.yaml (#3495)	3 years ago
Hubert Chathi	1ad5ff4179	Key name is supposed to be optional, as per MSC2874 (#3481)	3 years ago
Hubert Chathi	033038917d	remove extra `type` property (#3482)	3 years ago
Travis Ralston	195b8a54c5	v1.1 changelog	3 years ago
Travis Ralston	8f2e8f03d0	Normalize changelog entries (#3476) ... * Remove entries which don't affect the rendered spec (sorry people using the swagger schemas - we'll have to figure out a changelog for you). See https://github.com/matrix-org/matrix-doc/issues/3475 * Note that a breaking change is removed by this commit: key backup was introduced in this release cycle, so is not breaking. * Use uniform references to MSCs ("as per MSC0000"). * General rewording to be consistent with the overall voice of the changelog. * Condensing of entries where needed to make them fit in the changelog. * Rewording to collapse entries into fewer lines. * Spell "deprecation" correctly in file extension.	3 years ago
DeepBlueV7.X	938354b8b4	Rename threepidCreds to threepid_creds and get rid of array (#3471) ... This fixes the behaviour to match what synapse implements in practice. If you use threepidCreds, you will just get an error about a missing threepid_creds field. Synapse also treats this as an object. All clients also seem to send threepid_creds, if they work on Synapse. Since matrix.org requires an email currently for registration, most clients that implement registration, will hit this issue. a0f48ee89d/synapse/handlers/ui_auth/checkers.py (L145) fixes #3156 fixes #2189 Signed-off-by: Nicolas Werner <nicolas.werner@hotmail.de>	3 years ago
Travis Ralston	95d850c418	Update client-server API endpoints to move from r0 to v3 (plus whitespace fixes) (#3421) ... * Blind find & replace all on client major version -> v3 * Fix up bad replacements * Fix anchors for r0->v3 * Changelog	3 years ago
Travis Ralston	2d98cd3084	Describe new global specification versioning (#3420) ... * Update versioning specification for Matrix As per [MSC2844](https://github.com/matrix-org/matrix-doc/pull/2844) * Mention vX versioning in /versions * Changelog	3 years ago
Travis Ralston	b7e6104713	Remove extraneous mimetype from EncryptedFile examples, per MSC2582 (#3412) ... * Remove extraneous mimetype from EncryptedFile examples, per MSC2582 MSC: https://github.com/matrix-org/matrix-doc/pull/2582 * changelog	3 years ago
Travis Ralston	7e67aa2e23	Clarify how redacted_because actually works for events (#3411) ... * Clarify how redacted_because actually works for events * changelog * mention federation * Fix wording Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>	3 years ago
Richard van der Hoff	f8b83b7fb1	Replace "Pagination" section in C-S API with text in appendices (#3366) ... The Pagination section in the C-S API was, basically, full of rubbish. I think that anything of any value it contained was repeated either directly on the API definitions or in the text specific to syncing at https://spec.matrix.org/unstable/client-server-api/#syncing. The conventions I've added to the Appendices are based on the discussions in #1898. They are there because I don't want to have to go through it all again next time we add a paginated API. Fixes: #1898 Fixes: #2268	3 years ago
Richard van der Hoff	4b2bbbabcc	Start a 'conventions' section in the Appendices (#3350) ... I wanted a section for "here's what new APIs ought to do", which isn't really very useful for consumers of the existing APIs.	3 years ago
Alexey Rusakov	6d2c388144	Merge pull request #3336 from lukaslihotzki/include-peek-events ... OpenAPI: include peekEvents	3 years ago
Denis Kasak	14ed131761	Add newsfragment for #3339. (#3342)	3 years ago