matrix-spec-proposals

Commit Graph

Author	SHA1	Message	Date
Aaron Raimist	419d8cbd94	Update the default room version to 9 (#3739 ) * Update the default room version to 9 Spec PR for [MSC3589](https://github.com/matrix-org/matrix-doc/pull/3589) Signed-off-by: Aaron Raimist <aaron@raim.ist> * Add changelog 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
Tulir Asokan	be3b8e3a3c	Fix join membership auth rules when `join_rule` is knock (#3737 ) Fixes #3736	2 years ago
Travis Ralston	8a0a799a4b	Clarify that the X-Matrix validation uses the parsed request body (#3727 )	2 years ago
Richard van der Hoff	ca466b5a57	Attempt to clarify how `event_match` works (#3690 ) Fixes #3082, #2637, #3075.	2 years ago
Will Hunt	c420fc49a0	Fix m.login.appservice -> m.login.application_service (#3711 ) * Fix m.login.appservice -> m.login.application_service Implementations seem to agree with the proposal, so I'd suggest we fix the typo in the spec. I don't think this needs a MSC as the original proposal was fine, and this was just a copy error. * Create 3711.clarification * Update 3711.clarification * Update changelogs/3711.clarification Co-authored-by: Travis Ralston <travisr@matrix.org> Co-authored-by: Travis Ralston <travisr@matrix.org>	2 years ago
Travis Ralston	e488a7fb6d	v1.2 changelog	2 years ago
Travis Ralston	0f9eadd1a1	Fix knock->leave transition in auth rules (#3694 ) * Fix knock->leave transition in auth rules This was an oversight from knocking being added. For safety, this has been verified as at least intended by Synapse to work: `f5e2cde3f5/synapse/event_auth.py (L390-L391)` * changelog	2 years ago
devonh	dd32431b85	Fix broken link in server-server signing events section (#3528 ) Co-authored-by: Andrew Morgan <andrew@amorgan.xyz>	2 years ago
devonh	fc5ba959ca	Separate PDU terms from their definitions (#3527 ) Co-authored-by: Andrew Morgan <andrew@amorgan.xyz>	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
Travis Ralston	d4c74d37a9	Update documentation style & fix room version heading order (#3683 ) * Update documentation style & fix room version heading order Also add a missing signing key section to v6. This additionally contains various edits to the fragments to have them make a little bit more sense in context. Finally, this updates various aspects of the documentation style which haven't previously been considered - they're added here considering we're in the area. * changelog * enhanced changelogs * Minor wording adjustments * Apply suggestions from code review 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
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
Travis Ralston	59f4d7ffed	Revert fix to appendices	2 years ago
Matthew Hodgson	20aa44bd13	typoes (#3680 ) * typoes * Appease the faulty spellcheck on the json too Co-authored-by: Travis Ralston <travisr@matrix.org>	2 years ago
Matthew Hodgson	c151353956	s/master/main/g otherwise we link to stale content	2 years ago
Travis Ralston	4a597ace51	Re-add knock's `otherwise, reject` per MSC2403 (#3661 ) * Re-add knock's `otherwise, reject` per MSC2403 Fixes https://github.com/matrix-org/matrix-doc/issues/3648 * changelog + changelog for 3432	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	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	00169abcdb	Specify module order manually to work around hugo issues (#3612 )	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	20bd445602	Add a changelog for the appendices (#3609 ) As a document which is versioned, we should have a changelog for it. It might be empty most of the time but oh well.	2 years ago
Travis Ralston	592cbd537c	Describe `matrix:` URI scheme (#3608 ) * Copy spec PR near-verbatim from past PR With light review being addressed. https://github.com/matrix-org/matrix-doc/pull/3168 * Alter for modern day * Add changelog * specify that we're using the grammar	2 years ago
Travis Ralston	afc5298f11	Replace s2s join sequence diagram for legibility (#3603 ) Without the vertical lines it's a bit difficult to parse. A different tool was used to generate the graph this time.	2 years ago
Travis Ralston	afb6867232	Decorate the rest of the appservice login stuff too	2 years ago
Travis Ralston	76aaf39811	Decorate Matrix version on appservice login	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
homersimpsons	9efe1887a4	instant_messaging: fix intra docs anchors (#3601 ) Signed-off-by: homersimpsons <guillaume.alabre@gmail.com>	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 )	3 years ago
Travis Ralston	0fbc6bdab6	Definition of "Standard Identifier Format" (#3171 ) Spec for https://github.com/matrix-org/matrix-doc/pull/2758	3 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
Richard van der Hoff	f4a0c1aac5	Clarify event format text in room version specs (#3501 ) Split the text about event IDs and event formats into separate sections. This is largely to make it easier to link to, but I think the resulting text makes more sense too.	3 years ago
Hubert Chathi	1ad5ff4179	Key name is supposed to be optional, as per MSC2874 (#3481 )	3 years ago
Travis Ralston	195b8a54c5	v1.1 changelog	3 years ago
Travis Ralston	a5a27f69af	Hide room version fragments from table of contents (#3479 ) The entries were text-less and not really helping anyone. They are included as pages because we need them for templating, but we don't need people to be able to land on them directly.	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	241e01c332	Fully specify room versions (#3432 ) * Fully specify room versions * Misc typo clarifications * Try to clarify redactions a bit * Update content/client-server-api/_index.md Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * Update content/rooms/v6.md Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * Update content/rooms/v6.md Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> * Better describe client considerations * Doc template params * Move redaction "new stuff" to v3 * Remove unhelpful sentences about "here follows unchanged stuff" * Simplify event signing text * Clean up handling redactions sections * Move v4's event schema to unchanged section * Update content/rooms/v4.md 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
Andrew Morgan	00bf1b3f2f	fix typo: word plural	3 years ago
Travis Ralston	e8674688e6	Release process: changelog generation and docs (#3446 ) * Remove extra pyprojects and update changelog docs * Add script for rendering the changelog * Add docs for how to release the spec * Move legacy changelogs out of the way	3 years ago
Travis Ralston	5be0df02c5	Start annotating which version of the spec added a thing (#3425 ) * Introduce a new "added-in" template and use it on endpoints * Use "added-in" on schema properties too * Annotate sections of the spec with their added versions * Demo of "added-in" on a room version (to be fleshed out) * Use clearer versioning semantics * Update and fix validator for Swagger custom properties * Fix docs	3 years ago
Travis Ralston	649fc2bdd2	Move room version spec to `/rooms` (#3423 ) * Cut/paste room version spec to its own page * Move grammar to bottom + add feature matrix The version grammar is not as interesting as the actual room versions, so this moves that whole section to the bottom. * Fix all links to room versions	3 years ago

1 2 3

147 Commits (b26aa7fcf541a4e23ac5c8a16b8d609c8c63b005)