Commit graph

5313 commits

Author SHA1 Message Date
Hubert Chathi
40ec1ae1a9
clarification 2020-05-22 15:01:32 -04:00
Hubert Chathi
64b1ea3323
clarify which key again 2020-05-22 15:00:44 -04:00
Hubert Chathi
915e698c23
clarify which key 2020-05-21 16:48:27 -04:00
Travis Ralston
e264124faa
Merge pull request #2472 from uhoreg/symmetric_ssss
MSC2472: Symmetric SSSS
2020-05-21 08:36:49 -06:00
Travis Ralston
12ecf9f383
Merge pull request #2561 from matrix-org/travis/doc-2xx-format
Mention that we use OpenAPI 3's response code format
2020-05-21 07:46:51 -06:00
Travis Ralston
ab62b6293c
Merge pull request #2560 from matrix-org/travis/clarify-txn-send
Fix the response format of the `/send` endpoint
2020-05-21 07:46:08 -06:00
Travis Ralston
899db411a3
Merge pull request #2433 from matrix-org/travis/spec/msc2324-early-releases
Attempt to convert MSC2324 (facilitating early releases of implementations) to reality
2020-05-21 07:41:45 -06:00
Travis Ralston
98416bf948 Add changelog for client-server API 2020-05-20 22:16:16 -06:00
Travis Ralston
66ab480967 Incorporate MSC2540 (Canonical JSON validation)
MSC: https://github.com/matrix-org/matrix-doc/pull/2540
2020-05-20 22:14:29 -06:00
Travis Ralston
74c51b05a4 Incorporate MSC2209 (notifications auth rules)
MSC: https://github.com/matrix-org/matrix-doc/pull/2209

The changes are slightly difficult to word without dumping the text in and playing a game of spot the difference, so we now use our pre-existing pygments support to render a representation of the difference. The difference is shown in markdown-like format instead of RST for ease of understanding. It's also not rendered HTML for largely complexity reasons.
2020-05-20 22:14:29 -06:00
Travis Ralston
a1324aa9dc Move MSC2432 (alias handling) to v6 2020-05-20 22:14:11 -06:00
Travis Ralston
be35311559 s/should/must for redaction algorithm
This feels like it was a mistake some time ago considering the redaction algorithm is used in very strict algorithms like event signing.
2020-05-20 22:14:11 -06:00
Travis Ralston
0300a3cab4 Move redaction algorithm into room version specification
We stick it in a client section of v1 as the earliest version to define the algorithm is v1, and the client-server spec tells clients to use this algorithm.
2020-05-20 22:14:11 -06:00
Travis Ralston
2b6086d87c Add changelog entries
It's a bit awkward that this shows up as a backwards compatible change, but it's also not breaking.
2020-05-20 20:15:09 -06:00
Travis Ralston
b11cf560b5 Add spec for new alias handling (client-server)
MSC: https://github.com/matrix-org/matrix-doc/pull/2432

This commit does not deal with areas which will be covered by the room version specifications (namely the redaction algorithm).

It feels a bit overly cruel to completely obliterate all mentions of `m.room.aliases` from the spec as client/server developers may encounter the event type in the wild. To ensure that CTRL+F still works, a brief mention that they do nothing has been put in place, leaving no other references (except the redaction algorithm - see previous paragraph).
2020-05-20 20:10:52 -06:00
Travis Ralston
1388742a52 Mention that we use OpenAPI 3's response code format
See comments of https://github.com/matrix-org/matrix-doc/pull/2238
2020-05-20 18:00:27 -06:00
Travis Ralston
8220de58bd Drop loudly and instead encourage 2020-05-20 17:48:13 -06:00
Travis Ralston
04e8244dbc
Clarify various bits of wording
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2020-05-20 17:44:40 -06:00
Travis Ralston
74b627ac0b Fix the response format of the /send endpoint
Fixes https://github.com/matrix-org/matrix-doc/issues/2236
2020-05-20 17:42:15 -06:00
Travis Ralston
3875d50de8 Add missing changelog 2020-05-20 07:50:39 -06:00
Patrick Cloke
07716711f1
Give more guidance on how invalid events should be handled.
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2020-05-20 08:58:32 -04:00
Kegsay
86d4a6f786
Merge pull request #2559 from matrix-org/kegan/backfill-wording
Make backfill wording clearer
2020-05-20 11:07:59 +01:00
Kegsay
fc91946e5a
Update api/server-server/backfill.yaml
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2020-05-20 11:07:35 +01:00
Kegan Dougal
9765116c47 Make backfill wording clearer 2020-05-20 10:11:30 +01:00
Patrick Cloke
f5ebe33a9c Reword how bad values are handled. 2020-05-19 14:35:11 -04:00
Travis Ralston
10e4ad72ca
Clarify retention of information for soft logout
Co-authored-by: Hubert Chathi <hubert@uhoreg.ca>
2020-05-19 11:58:28 -06:00
Travis Ralston
05e83f2e7d Fix more describes -> describe 2020-05-19 09:55:55 -06:00
Travis Ralston
0e771c7b07
Merge pull request #2547 from matrix-org/travis/spec/1802-fix-200
Spec v2 send_join and send_leave endpoints
2020-05-19 08:11:04 -06:00
Travis Ralston
7c0046ffc7 describes -> describe 2020-05-19 08:09:19 -06:00
Travis Ralston
d419e3b38a Remove extraneous spaces 2020-05-19 08:08:31 -06:00
Travis Ralston
77d83b9ce5 Clarify that soft logout is about client state 2020-05-19 08:05:47 -06:00
Travis Ralston
c2d5516517 Clobber changelogs 2020-05-18 00:24:05 -06:00
Travis Ralston
749be9ddf2
Merge pull request #2554 from deepbluev7/number-fixes
Fix some numbers in the spec text.
2020-05-18 00:21:34 -06:00
Travis Ralston
f9af712e1b
Merge pull request #2526 from uhoreg/e2e_delete_backup
MSC2526: Add ability to delete key backups
2020-05-18 00:20:44 -06:00
Travis Ralston
ddeb695b97
Use 'several' in place of counting 2020-05-18 00:19:30 -06:00
Nicolas Werner
a7e7496cd6 Fix some numbers in the spec text.
Odds were not written as an exponent.
Special tag names count was not updated.

Fixes #2550

Signed-off-by: Nicolas Werner <nicolas.werner@hotmail.de>
2020-05-17 22:20:29 +02:00
Matthew Hodgson
b8f13ac35e
Merge pull request #2553 from Dominaezzz/patch-1
Fix Typo
2020-05-17 11:33:09 +01:00
Dominic Fischer
c3582e5fc6
Add changelog 2020-05-16 21:41:09 +01:00
Dominic Fischer
28d460fb62
Fix Typo 2020-05-16 21:35:26 +01:00
Travis Ralston
19cac03305
Update specification/client_server_api.rst
Co-authored-by: Hubert Chathi <hubert@uhoreg.ca>
2020-05-15 22:45:18 -06:00
Travis Ralston
a2a1694c35 Spec v2 send_join and send_leave endpoints
MSC: https://github.com/matrix-org/matrix-doc/pull/1802

Fixes https://github.com/matrix-org/matrix-doc/issues/2541

This also adds the v2 invite endpoint to the ACL protected list as that appears to be an omission.
2020-05-15 14:10:06 -06:00
Travis Ralston
54102b8d36 Clarify wording per review suggestions 2020-05-15 13:50:17 -06:00
Travis Ralston
a15fe3723d Merge master into MSC2342 spec 2020-05-15 13:46:56 -06:00
Travis Ralston
b4beb05dde Remove excess whitespace 2020-05-15 13:44:21 -06:00
Travis Ralston
bd26a41114 off by one error 2020-05-15 13:42:08 -06:00
Travis Ralston
d24f15a3a9 Spec soft-logout per MSC1466
MSC: https://github.com/matrix-org/matrix-doc/issues/1466
2020-05-15 13:41:13 -06:00
Hubert Chathi
fae1165e1c spec what to do if you try to delete a backup that's already deleted 2020-05-15 12:17:37 -04:00
Hubert Chathi
bac9afa124 document error codes and remove a statement that isn't true 2020-05-15 12:14:46 -04:00
Patrick Cloke
e5fa76c8ed
Clarify range a bit more. 2020-05-15 10:53:26 -04:00
Patrick Cloke
007c8b5799
Clarify the range of valid values. 2020-05-15 10:52:29 -04:00