Commit graph

3737 commits

Author SHA1 Message Date
Travis Ralston
890fb1a019 Fix examples for new schema
Fix missed example in make_join

Fix state array in response of send_join

Try removing examples from send_join?

Try printing more information about the error

Copy/paste known working examples

Try schema definitions in the response?
2019-02-01 11:14:42 -07:00
Travis Ralston
5d8fa65e6e De-duplicate state keys 2019-02-01 10:11:39 -07:00
Travis Ralston
33406e4662 Apply event format warnings to the remainder of the s2s spec 2019-02-01 10:08:30 -07:00
Travis Ralston
d94a70f49d Warn clients about changes in event format 2019-02-01 08:40:18 -07:00
Travis Ralston
9b214ec16d Make the backfill response aware of event format changes 2019-02-01 08:40:18 -07:00
Travis Ralston
e27c83d9f8
Merge pull request #1817 from matrix-org/neilj/remove_presence_lists
remove references to presence lists
2019-02-01 08:37:08 -07:00
Travis Ralston
41e50d553e
Merge pull request #1830 from matrix-org/travis/spec/x509-wk
Specify .well-known s2s discovery and X.509 validation
2019-02-01 08:36:55 -07:00
Travis Ralston
6421582bf2 Clarifications and alter the error handling of .well-known
Note that MSC1831 changes the order, so the changes to MSC1708 might not make sense when combining all the proposals together. However, independently the change should make sense.
2019-02-01 08:18:12 -07:00
Richard van der Hoff
39b71413be
Update specification/server_server_api.rst
Co-Authored-By: turt2live <travpc@gmail.com>
2019-02-01 07:40:39 -07:00
Travis Ralston
1c30f5eba9 Clarify certificate usage and ports 2019-01-31 21:15:47 -07:00
Travis Ralston
df01acc6e2
Merge pull request #1828 from matrix-org/travis/spec/rooms-v3
Add specification for room version 3: Event IDs as hashes
2019-01-31 17:59:31 -07:00
Travis Ralston
a6243da03f Wording changes and links 2019-01-31 17:58:42 -07:00
Travis Ralston
48912a7320 Fix auth rules of redactions in v3 2019-01-31 17:35:25 -07:00
Travis Ralston
ad64af3f01 Clarify how reference hashes are done 2019-01-31 17:22:55 -07:00
Travis Ralston
01556e5b17 Clarifications and bug fixes in how v3 rooms work 2019-01-31 16:44:37 -07:00
Travis Ralston
3c17a0e53b Mention caching 2019-01-31 16:29:07 -07:00
Travis Ralston
b971bcee7d Accurately represent the 3 proposals and provide more detail 2019-01-31 16:24:07 -07:00
Travis Ralston
fb36757869
Merge pull request #1833 from matrix-org/travis/misc/domain-security
Document domain reuse concerns
2019-01-31 16:07:21 -07:00
Travis Ralston
48e4d6e412 Document domain reuse concerns
Fixes https://github.com/matrix-org/matrix-doc/issues/1783
2019-01-31 12:27:09 -07:00
Travis Ralston
0f3aa3fa8a
Merge pull request #1829 from matrix-org/travis/spec/c2s-caps
Specify how capabilities work in the c2s API
2019-01-31 12:03:41 -07:00
Travis Ralston
d2f012f4ea Incorporate MSC1831
Original proposal: https://github.com/matrix-org/matrix-doc/pull/1831

Implementation proof: pending
2019-01-31 11:17:56 -07:00
Travis Ralston
c888f3f080 Make example strings more legible 2019-01-31 00:09:30 -07:00
Travis Ralston
0347e873ef Specify .well-known s2s discovery and X.509 validation
Original proposals:
* https://github.com/matrix-org/matrix-doc/pull/1708 (note: the JSON requirements were softened by https://github.com/matrix-org/matrix-doc/pull/1824)
* https://github.com/matrix-org/matrix-doc/pull/1711

Implementation proofs:
* https://github.com/matrix-org/synapse/pull/4489
* No explicit PRs for MSC1711 could be found, however Synapse is known to implement it.

There are no intentional changes which differ from the proposals in this commit, however the author has relied upon various historical conversations outside of the proposals to gain the required context. Inaccuracies introduced by the author are purely accidental.
2019-01-30 22:11:31 -07:00
Travis Ralston
9193d57dfd full stop 2019-01-30 19:47:16 -07:00
Travis Ralston
ccce6c196d Specify how capabilities work in the c2s API
Original proposals:
* https://github.com/matrix-org/matrix-doc/pull/1753
* https://github.com/matrix-org/matrix-doc/pull/1804

Implementation proof:
* https://github.com/matrix-org/synapse/pull/4472
* https://github.com/matrix-org/matrix-js-sdk/pull/830

There is one change to MSC1753 which is included in this commit. MSC1804 remains unchanged. In the original proposal, the change password capability being present was an indication that password changes were possible. It was found that this doesn't really communicate the state very well to clients in that lack of a capability (or a 404, etc) would mean that users would erroneously not be able to change their passwords. A simple boolean flag was added to assist clients in detecting this capability.
2019-01-30 19:43:55 -07:00
Travis Ralston
72a2871021
Merge pull request #1804 from matrix-org/travis/msc/room-version-client-advertising
MSC1804: Advertising capable room versions to clients
2019-01-30 17:06:24 -07:00
Travis Ralston
ff75996524 Add specification for room version 3: Event IDs as hashes
Original proposal: https://github.com/matrix-org/matrix-doc/pull/1659
Implementation proofs (some traversing of the PR tree may be required to get all of them):
* https://github.com/matrix-org/synapse/pull/4483
* https://github.com/matrix-org/synapse/pull/4499

This doesn't intentionally change anything from the proposal.

**Implementation details**:

The simple part of this is the introduction of a rooms/v3.html document. The somewhat unclear part is the stuff done to the s2s definitions. This pulls `unsigned_pdu` out to `unsigned_pdu_base` (all fields except `event_id`) where it can be reused in `pdu` and `pdu_v3` (for rooms v3). These definitions are further moved into the room version specifications where they can highlight the exact schemas in detail.

Version 1 has been updated to include the pre-existing event format, however the core principles of the room have not been changed. The same applies to room version 2. Room versions have immutable core principles once in the spec, otherwise these format changes would land in a pre-existing version.

The client-server API event formats will need updating, however that is being punted to a different commit to try and keep these changes reviewable.
2019-01-30 17:03:03 -07:00
Travis Ralston
4437c383bb
Merge pull request #1790 from matrix-org/travis/spec/login-redirect
Add a mechanism for redirecting clients after login
2019-01-30 13:33:03 -07:00
Erik Johnston
1c0742ed6a
MSC 1659 Proposal: Change Event IDs to Hashes (#1659) 2019-01-30 17:08:21 +00:00
Neil Johnson
afd399d7d4 remove unused schema defs 2019-01-30 11:43:30 +00:00
Neil Johnson
c09fa6845e
Update presence.rst 2019-01-29 18:23:30 +00:00
Travis Ralston
d2b35e5150
Merge pull request #1821 from matrix-org/travis/spec/rver-make-memberships
Specify the room_version response property on /make_{leave|join}
2019-01-29 10:19:13 -07:00
Travis Ralston
2c3ba0b135
Merge pull request #1813 from matrix-org/erikj/make_membership_room_ver
MSC 1813 - Federation Make Membership Room Version
2019-01-29 10:17:48 -07:00
Travis Ralston
00adfdbf4a
Merge pull request #1820 from matrix-org/travis/spec/fed-v2-invite
Specification for v2 s2s invite API
2019-01-29 09:12:21 -07:00
Erik Johnston
c0039c30f2
Minor wording changes from code review
Co-Authored-By: turt2live <travpc@gmail.com>
2019-01-29 09:05:20 -07:00
Andrew Morgan
3374d22b52
Merge pull request #1823 from matrix-org/anoa/majority_update
75% majority now required for FCP
2019-01-29 14:49:34 +00:00
Richard van der Hoff
de57d3950f
Relax the requirement for a content-type on .well-known (#1824)
The main reason for this is that Apache etc won't stick a content-type on by
default, because they don't know it's JSON, so requiring it seems like it will
require unnecessary hoop-humping for everyone who wants to use a .well-known.
2019-01-29 14:46:27 +00:00
Andrew Morgan
0712fd36a2 75% majority now required for FCP 2019-01-29 14:36:26 +00:00
Travis Ralston
d12593feea Specify the room_version response property on /make_{leave|join}
Original proposal: https://github.com/matrix-org/matrix-doc/pull/1813
Implementation proof: https://github.com/matrix-org/synapse/pull/4447

There are no changes from the original proposal.
2019-01-28 22:17:51 -07:00
Travis Ralston
aca9437bf3 Specification for v2 s2s invite API
Original proposal: https://github.com/matrix-org/matrix-doc/pull/1794
Implementation proofs:
* https://github.com/matrix-org/synapse/pull/4402
* https://github.com/matrix-org/synapse/pull/4496

There are no changes from the original proposal.
2019-01-28 21:07:00 -07:00
Neil Johnson
ed68f940cd towncrier 2019-01-28 17:49:20 +00:00
Neil Johnson
bf2b6e6daa remove references to presence lists 2019-01-28 15:05:10 +00:00
Richard van der Hoff
9f443225ac fix incorrect spelling of homeserver 2019-01-26 20:10:32 +00:00
Travis Ralston
577edeb53b Say that !stable == unstable 2019-01-25 09:27:23 -07:00
Travis Ralston
6c7eea555a
Merge pull request #1773 from matrix-org/travis/spec/rooms
Add a room version specification
2019-01-24 09:47:33 -07:00
Travis Ralston
84a4ca62c3
Merge pull request #1786 from matrix-org/travis/spec/exp-caps
Add support for unstable feature advertising via /versions
2019-01-23 19:15:50 -07:00
Travis Ralston
052d68d83d
Merge pull request #1791 from matrix-org/travis/spec/rver-upgrades
Add room version upgrades
2019-01-23 19:04:24 -07:00
Travis Ralston
413bfaeb68 Add clarification that clients shouldn't use unstable things as stable 2019-01-23 19:03:14 -07:00
Travis Ralston
061f59547a Minor wording changes 2019-01-23 09:10:14 -07:00
Hubert Chathi
5cafcd103f
Fix copyright
> Since this is a copy-and-paste of old text, I think the copyright year should match when the original text was written, which according to git was 2017.

Co-Authored-By: turt2live <travpc@gmail.com>
2019-01-22 21:43:32 -07:00