Commit graph

1502 commits

Author SHA1 Message Date
Hubert Chathi
a1177cbd61
Merge pull request #2566 from uhoreg/remove_string_string_string
E2E clarifications/improvements
2020-05-25 13:01:47 -04:00
Travis Ralston
b876ac5893 Clarify which server names to sign requests with
Fixes https://github.com/matrix-org/matrix-doc/issues/2512
2020-05-25 08:27:55 -06:00
Tulir Asokan
5270ed0c0a Fix typo in read markers module
Signed-off-by: Tulir Asokan <tulir@maunium.net>
2020-05-24 14:24:49 +03:00
Hubert Chathi
6a8ba9b1d6 improve description of key object in CS and include a link in Fed 2020-05-22 16:10:16 -04: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
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
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
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
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
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
77d83b9ce5 Clarify that soft logout is about client state 2020-05-19 08:05:47 -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
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
d24f15a3a9 Spec soft-logout per MSC1466
MSC: https://github.com/matrix-org/matrix-doc/issues/1466
2020-05-15 13:41:13 -06:00
Travis Ralston
10293d6951
Merge pull request #2532 from matrix-org/clokep/sso-login
Add MSC2454 to the specification.
2020-05-11 14:02:38 -06:00
Patrick Cloke
e85f6c31a3
Fix a typo found in review.
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2020-05-11 15:14:11 -04:00
Patrick Cloke
78f8d1322f Add MSC2454 to the specification. 2020-05-08 11:28:59 -04:00
Hubert Chathi
a896729ac2 some more clarifications and indentation fixes 2020-05-06 17:11:41 -04:00
Hubert Chathi
0145191d43 add links to endpoints and add delete endpoint 2020-05-05 20:00:45 -04:00
Hubert Chathi
3d1c33ed1b move API definitions into backup section 2020-05-05 18:09:35 -04:00
Hubert Chathi
5f3ee44cfb add more suggestions from review 2020-05-05 18:09:17 -04:00
Hubert Chathi
e89521d195 some fixes (spelling, RST, and naming) 2020-05-04 22:08:22 -04:00
David Vo
0ae597626a Fix .m.rule.contains_user_name push rule to highlight
Signed-off-by: David Vo <david@vovo.id.au>
2020-05-01 00:32:15 +10:00
Travis Ralston
a3385126a7
Merge pull request #2507 from matrix-org/travis/proposal-buckets
Add some words about what categories are
2020-04-27 10:06:08 -06:00
Travis Ralston
16905a2f5b Make the spec core team the Spec Core Team 2020-04-22 14:31:34 -06:00
Rudi Floren
b5868a59d6
Fix typo in Fed. API request auth python example
Fixes the typo in the Request Authentication python example. It seems like a copy paste error.

Closes: #2509
Signed-off-by: Rudi Floren <rudi.floren@gmail.com>
2020-04-22 22:18:28 +02:00
Travis Ralston
3c34d83082 Add some words about what categories are 2020-04-22 13:37:50 -06:00
Lukas Lihotzki
af7cf84083 Fix iv parameter description
Signed-off-by: Lukas Lihotzki <lukas@lihotzki.de>
2020-04-07 17:54:09 +02:00
Patrick Cloke
fc03f7faa6 Remove query_auth from the specification per MSC2451. 2020-03-24 12:42:15 -04:00
Hubert Chathi
9e7bcaac9c
Merge pull request #2465 from uhoreg/state_res_clarification
clarify first run of iterative auth checks
2020-03-24 10:36:21 -04:00
Hubert Chathi
30586ed98c remove extra space 2020-03-20 16:55:56 -04:00
Hubert Chathi
e67ba0cd05 add note indicating similarity between key backup format and key exports
also copy description of forwarding_curve25519_key_chain from key exports, since
it's a better description
2020-03-20 16:49:53 -04:00
Hubert Chathi
2b71234f3c clarify first run of iterative auth checks 2020-03-19 14:39:54 -04:00
Travis Ralston
79b2e5263d
Update specification/proposals_intro.rst
Co-Authored-By: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2020-03-07 14:05:05 -07:00
Runster
e6c7eac023
Correct name of Phil Zimmermann 2020-03-06 18:11:28 +01:00
Travis Ralston
da795e5824
Apply suggestions from code review
Co-Authored-By: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2020-03-05 17:24:29 -07:00
Travis Ralston
6d475ebd57
Remove whitespace
Co-Authored-By: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2020-02-17 12:56:28 -07:00
Travis Ralston
c7942d1cec Spec moderation policy rooms (MSC2313)
MSC: https://github.com/matrix-org/matrix-doc/pull/2313
2020-02-12 21:58:57 -07:00
Travis Ralston
3ee9a7d654 Attempt to convert MSC2324 to reality
We've been using this in practice for a while now, so we should document it more officially. 

MSC: https://github.com/matrix-org/matrix-doc/pull/2324
2020-02-12 21:03:11 -07:00
Hubert Chathi
41072fcaa9
Apply suggestions from code review
Co-Authored-By: Matthew Hodgson <matthew@arasphere.net>
2020-02-07 15:28:19 -05:00