matrix-spec-proposals

Commit Graph

Author	SHA1	Message	Date
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
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
Andy Balaam	2fc3982568	Remove extra 'an' from spec index (#3433 ) Signed-off-by: Andy Balaam <andyb@element.io>	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
Jonas Platte	6e78cde3eb	Fix wrong matrix.to URL in spec appendices (#3409 )	3 years ago
Denis Kasak	ed08c1cb9e	Tweak PDU diagram demonstrating `prev_events`. (#3340 ) This tweaks the DAG to be simpler, with two linear event chains E4 -> E3 -> E2 -> E1 and E6 -> E5 -> E2 -> E1. The extremities of the DAG are now the first and only point in the DAG where multiple event parents occur. Since the point of the diagram is to demonstrate this very situation, it's better didactically if there is only one such situation in the diagram.	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
Neil Alexander	3d278b891d	Add clarification on binary data and base64 encoding to Appendices (#3362 ) * Add clarification on binary data and base64 encoding (closes #3341) * Add changelog fragment * Delete 3362.clarification	3 years ago
ColonisationCaptain	7c58999c6a	Insert missing space Insert missing space	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
Niels Basjes	cf5b519963	Explain the reasons why `<hostname>` TLS certificate is needed rather than `<delegated_hostname>` for SRV delegation. (#3322 ) Signed-off-by: Niels Basjes <niels@basjes.nl>	3 years ago
Travis Ralston	f433e07763	Merge pull request #3225 from sideshowbarker/client-server-api-Access-Control-Allow-Headers-drop-Options-Accept Drop Origin & Accept from Access-Control-Allow-Headers value	3 years ago
Michael[tm] Smith	d7cf63d981	Drop Origin & Accept from Access-Control-Allow-Headers value This change drops the Origin and Accept header names from the recommended value for the CORS Access-Control-Allow-Headers header. Per the CORS protocol, it’s not necessary or useful to include them. Per-spec at https://fetch.spec.whatwg.org/#forbidden-header-name, Origin is a “forbidden header name” set by the browser and that frontend JavaScript code is never allowed to set. So the value of Access-Control-Allow-Headers isn’t relevant to Origin or in general to other headers set by the browser itself — the browser never ever consults the Access-Control-Allow-Headers value to confirm that it’s OK for the request to include an Origin header. And per-spec at https://fetch.spec.whatwg.org/#cors-safelisted-request-header, Accept is a “CORS-safelisted request-header”, which means that browsers allow requests to contain the Accept header regardless of whether the Access-Control-Allow-Headers value contains "Accept". So it’s unnecessary for the Access-Control-Allow-Headers to explicitly include Accept. Browsers will not perform a CORS preflight for requests containing an Accept request header. Related: Related: https://github.com/matrix-org/synapse/pull/10114 Signed-off-by: Michael[tm] Smith <mike@w3.org>	3 years ago
ilovecommits	175e3c157d	Correct 'once-off' to 'one-off'	3 years ago
Travis Ralston	30654f70ee	Merge pull request #3176 from matrix-org/travis/clarification/lowercasing Case fold instead of lowercase	3 years ago
Hubert Chathi	221375b105	Merge pull request #3207 from toadjaune/patch-2 Fix a typo in event soft rejection schema	3 years ago
Travis Ralston	8b40972872	iterate	3 years ago
Hubert Chathi	586c4d865a	Fix broken ASCII art	3 years ago
Travis Ralston	21a132d3a5	Merge branch 'master' into travis/clarification/lowercasing	3 years ago
Hubert Chathi	f9c9fce1ad	Deprecate verifications that don't begin with a request.	3 years ago
Arnaud Venturi	0d275cc739	Fix a typo in event soft rejection schema Signed-off-by: Arnaud Venturi <github@toadjaune.eu>	3 years ago
Travis Ralston	4cb667ca27	Case fold instead of lowercase Fixes https://github.com/matrix-org/matrix-doc/issues/3175	3 years ago
Andrew Morgan	fca6992cd9	Clarify that implementations can use stable prefixes once an MSC has merged (#3179 ) Fixes #3146. This PR changes the Matrix Spec Proposals page to clarify that implementations do not need to wait until a spec release to use stable prefixes, but that they can do so after the corresponding MSC has been merged. The justification is that once an MSC has been merged, it's fairly guaranteed that it will land in the spec. Yet it will take time for the spec release process to run its course, and we shouldn't make implementations wait for that. The exception to this is if implementating a feature in a backwards-compatible way requires a new spec version to indicate to clients/servers that a feature has been added/changed. This situation is rare though, and most implementations won't fall into this category.	3 years ago
Andrew Morgan	5d0d5a3981	Clarify what happens when a concern is raised during FCP (#3180 ) It wasn't entirely clear what should happen to the FCP timer (and state) when a concern is raised during FCP. After some discussion, we agreed that when a concern is raised: 1. FCP will continue to not conclude until at least 5 days have passed, but once those 5 days are up it still won't conclude until all concerns raised during FCP are resolved. 2. If a concern warrants a large enough change in the document, then the Spec Core Team may consider cancelling FCP and restarting the timer in order for people to have some time to think about and review the new changes.	3 years ago
Travis Ralston	a5fea91d86	Merge pull request #3177 from matrix-org/travis/spec/spaces-groups-rm Remove group identifiers	3 years ago
Travis Ralston	3d217e0de0	Merge pull request #3101 from matrix-org/travis/spec/MSC2320-identity-versions Add identity service versions API	3 years ago
Travis Ralston	3c01fa4681	Remove group identifiers Groups are replaced by https://github.com/matrix-org/matrix-doc/pull/1772 and this probably shouldn't have made it into the spec in the first place without the remaining context of Groups.	3 years ago
Travis Ralston	c11efb35fe	Merge pull request #3163 from matrix-org/travis/spec/msc2858-multisso Describe social-sign-on (multiple SSO providers)	3 years ago
Travis Ralston	fb3dde1c2c	Merge pull request #3167 from matrix-org/travis/spec/msc2265-lower-3pid Specify that email handling converts to lowercase first	3 years ago
Travis Ralston	466911b253	Merge pull request #3170 from matrix-org/travis/spec/msc2713-rm-v1-id Remove v1 identity service API	3 years ago
Travis Ralston	2c3d7b1682	Apply suggestions from code review Co-authored-by: Hubert Chathi <hubert@uhoreg.ca>	3 years ago
Travis Ralston	53833d49a5	Spelling	3 years ago
Travis Ralston	37c3a3f855	Remove v1 identity service API Spec for https://github.com/matrix-org/matrix-doc/pull/2713	3 years ago
Travis Ralston	49a5ca3553	Downgrade identity server failure to FAIL_PROMPT instead of FAIL_ERROR Spec for https://github.com/matrix-org/matrix-doc/pull/2284	3 years ago
Travis Ralston	fc6aa30000	Merge branch 'master' into travis/spec/MSC2320-identity-versions	3 years ago
Travis Ralston	3aa517a868	Clarify provider naming	3 years ago
Travis Ralston	7cef7d0fcf	Specify that email handling converts to lowercase first Spec for https://github.com/matrix-org/matrix-doc/pull/2265	3 years ago
Travis Ralston	457f3995af	Merge pull request #3154 from matrix-org/travis/spec/knock-knock-whos-there Add knocking to the spec	3 years ago
Travis Ralston	cbd761df17	Apply suggestions from code review Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>	3 years ago
Hubert Chathi	ec9ea2b6e3	Merge pull request #3149 from uhoreg/qr_codes_spec Add spec for verification by QR codes.	3 years ago

1 2 3

106 Commits (92b29cf8e6edcd70977a9cd7543fdf26c50b1c0f)