52643a92c6
Less confusing wording on Application Service's Legacy Routes ( #2160 )
...
https://matrix.org/docs/spec/application_service/r0.1.1#legacy-routes
The "becomes" wording made it a little bit confusing for which was the new route and which was the old.
5 years ago
5df86dabe0
Clarify the purpose of reference hashes.
...
The server-server specification describes a "reference hash" of an event
and how to calculate it, but is otherwise not mentioned anywhere else in
the document. This change adds a sentence to explain that they are used
for event identifiers in later room versions, which are described in
other documents.
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
5 years ago
9ed19a37ad
Client-server: Fix upload keys example request
...
Contributes to #1733
Signed-off-by: Alexey Andreyev <aa13q@ya.ru>
5 years ago
9208c5cd13
Add changelog
5 years ago
e88a074c9f
Add changelog
6 years ago
ace94f02b7
Merge pull request #2132 from jimmycuadra/clarify-m.key.verification.start
...
Clarify the distinction between *m.key.verification.start* and its *m.sas.v1* variant.
6 years ago
8246383330
Fix typos in changelog entry.
6 years ago
204601d9a4
Merge pull request #2133 from matrix-org/travis/fix-olm-2
...
Fix link to Olm signing specification
6 years ago
d09af5b191
Identity r0.2.1
6 years ago
c63b5aff69
Create 2136.clarification
6 years ago
33ca891e71
Fix link to Olm signing specification
...
See https://github.com/matrix-org/matrix.org/issues/478
6 years ago
5384b61d95
Fix style issues brought up during code review.
...
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
6 years ago
bc71dacaf4
Clarify the distinction between *m.key.verification.start* and its *m.sas.v1* variant.
...
Currently the *m.key.verification.start* event appears twice with the
exact same title, in the "Key verification framework" section and the
"Short Authentication (SAS) verification" section. It's not immediately
clear that the first occurrence describes the format of the event in
general terms and that the second occurrence describes the fields when
the *m.sas.v1* verification method is being used. This is a similar
relationship to the *m.room.message* event and its various *msgtype*
variants.
This commit does three things:
* It tweaks the generation of the documentation to change the title
of the second occurrence of *m.key.verification.start* to
distinguish it from the first.
* It updates the language in the description of the two versions of the
event to better describe the relationship between the two.
* It adds the optional `next_method` field to the schema of the
*m.sas.v1* variant, as specified in the general form of
*m.key.verification.start*.
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
6 years ago
b807e1cbe5
Merge pull request #2129 from jimmycuadra/conditionally-required-url-fields
...
Remove the "required" designation from the `url` field of certain m.room.message msgtypes.
6 years ago
aadf1cc733
Merge pull request #2131 from jimmycuadra/e2ee-easier-typo
...
Fix typo in key verification framework section.
6 years ago
b885714d94
Remove the "required" designation from the `url` field of certain
...
m.room.message msgtypes.
Now that content referenced by the *m.audio*, *m.file*, *m.image*, and
*m.video* message types can be encrypted, the `url` field is required
*only* if the content is unencrypted. The "required" designation in the
event schemas (which prefixes the field description with "Required" in
bold in the generated HTML) is used to indicate fields which must always
be present, and this is no longer the case.
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
6 years ago
2dd0da7d50
Fix typo in key verification framework section.
...
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
6 years ago
cac72ff873
Merge pull request #2126 from matrix-org/travis/403-id-unbind
...
Add 403 error to IS unbind
6 years ago
a9297f9e6c
Merge pull request #2125 from jimmycuadra/m.notice-format
...
Add missing format fields to m.room.message$m.notice schema.
6 years ago
e670fb1f5a
Add missing format fields to m.room.message$m.notice schema.
...
Signed-off-by: Jimmy Cuadra <jimmy@jimmycuadra.com>
6 years ago
67ea3b9ce8
Add 403 error to IS unbind
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2117
6 years ago
b8f1f37927
Remove incorrect id_server param from IS spec
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2118
6 years ago
98c9d93b20
Merge pull request #2113 from matrix-org/client_server/release-r0.5.0
...
Client-Server r0.5.0
6 years ago
497c6875ac
Merge pull request #2112 from matrix-org/server_server/release-r0.1.2
...
Federation r0.1.2
6 years ago
67d12165e8
Merge pull request #2111 from matrix-org/identity_service/release-r0.2.0
...
Identity r0.2.0
6 years ago
1ca60bf5d7
Client-Server r0.5.0
6 years ago
8e6ccf0a0e
Federation r0.1.2
6 years ago
34ad81e81b
Identity r0.2.0
6 years ago
4f915f2760
Appservice r0.1.1
6 years ago
2d18f81807
Merge pull request #2087 from matrix-org/travis/1.0/events-are-extensible
...
Reorganize event structure in c2s spec and clarify event capabilities
6 years ago
8ac555f870
Merge pull request #2083 from matrix-org/travis/1.0/key-object
...
Clarify the key object definition for the key management API
6 years ago
19f017f9bd
Merge pull request #2035 from matrix-org/travis/1.0/msc688-msc1227-lazy-loading
...
Spec lazy-loading room members
6 years ago
fbdb56a29f
Merge pull request #2101 from matrix-org/anoa/hs_3pid_tokens
...
Add submit_url field to requestToken responses, clarify HS's can send tokens themselves
6 years ago
6d60258e25
Merge pull request #2080 from matrix-org/travis/1.0/msc2076-msc2077-v5-rooms
...
Spec v5 rooms: Key validity
6 years ago
370ae8b9fe
Merge pull request #2068 from matrix-org/travis/1.0/mxc
...
Refactor documentation for content/media repository
6 years ago
b7378a860a
Merge pull request #2097 from matrix-org/travis/1.0/common-themes
...
Specify some of the common concepts for Matrix in the index
6 years ago
c1c26859e2
Merge pull request #2096 from matrix-org/travis/1.0/read-notifs
...
Clarify how notification counts are calculated in /sync
6 years ago
39b79fe453
Merge pull request #2088 from matrix-org/travis/1.0/duplicate-state-endpoint
...
Merge GET/PUT /state/:event_type endpoints
6 years ago
572d29348c
Update changelogs/client_server/newsfragments/2101.breaking
...
Co-Authored-By: Travis Ralston <travpc@gmail.com>
6 years ago
32761fc108
Merge pull request #2098 from matrix-org/travis/1.0/modules-update
...
Clarify what a "module" is and update feature profiles for clients
6 years ago
f047e235df
Merge branch 'master' into travis/1.0/event-ids
6 years ago
7fe7d365e2
Merge pull request #2089 from matrix-org/travis/1.0/cors
...
Clarify when and where CORS headers should be returned
6 years ago
0f82056ca2
Highlight breaking change
6 years ago
ab0c1bc054
Add changelog, update imperative check, rename sid.yaml
6 years ago
4b6e2cc956
Merge pull request #2072 from matrix-org/travis/1.0/msc1717-msc1267-sas-verification
...
Spec SAS verification and the common key verification framework
6 years ago
00588efd3f
Merge pull request #2086 from matrix-org/travis/1.0/fed-content-type
...
Clarify that the default s2s transport is JSON over HTTP
6 years ago
906d3cd447
Merge pull request #2055 from matrix-org/travis/1.0/registration-clarification
...
Clarify guest accounts and `auth` usage on /register
6 years ago
6a4a6db1bd
Merge pull request #2081 from matrix-org/travis/1.0/pdu-signatures
...
Clarify which servers are supposed to sign events
6 years ago
f4e85853d4
Merge pull request #2054 from matrix-org/travis/1.0/uia-clarifications
...
Clarify that UIA stages cannot be attempted twice
6 years ago
9cf03325b9
Merge pull request #2046 from matrix-org/travis/1.0/msc1915-unbind
...
Spec 3PID unbind API
6 years ago
70da564e2b
Merge pull request #2067 from matrix-org/travis/1.0/stripped-state
...
Clarify exactly what StrippedState is
6 years ago
cd6b012523
Clarify what a "module" is and update feature profiles for clients
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2009
6 years ago
b9c9396c11
Specify some of the common concepts for Matrix in the index
...
See https://github.com/matrix-org/matrix-doc/pull/2061
Fixes https://github.com/matrix-org/matrix-doc/issues/1468
Fixes https://github.com/matrix-org/matrix-doc/issues/1528
The section is not referenced by the specifications yet - they do a fairly good job of explaining it over and over. In future, it would be good to point all the references to the index.
6 years ago
f0eb495cee
Clarify how notification counts are calculated in /sync
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2015
6 years ago
9bf0103ef3
Clarify how many PDUs are in a given transaction object
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2093
6 years ago
e1266b859f
Merge pull request #2030 from matrix-org/travis/1.0/bind-msisdn
...
Spec MSISDN UIA support
6 years ago
976f32fcab
Clarify that /register must produce valid Matrix User IDs
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1793
6 years ago
79bbb47d9f
Clarify when authorization and rate-limiting are not applicable
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1971
6 years ago
bbc7401973
Clarify when and where CORS headers should be returned
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1736
Fixes https://github.com/matrix-org/matrix-doc/issues/2013
6 years ago
c8a3850598
Merge GET/PUT /state/:event_type endpoints
...
Clarifying that the state key is optional, and how that works.
Fixes https://github.com/matrix-org/matrix-doc/issues/1182
6 years ago
8fd5b15594
Reorganize event structure in c2s spec and clarify event capabilities
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1166
Fixes https://github.com/matrix-org/matrix-doc/issues/1527
Fixes https://github.com/matrix-org/matrix-doc/issues/1827
Note: In order to fix the "state events have the following fields: [no words]" bug (1827) we need to resolve references on common event types. When doing this we ultimately end up with more fields than may be required to explain the section, however this commit alters the section descriptions to just say "these fields" instead of "these additional fields".
This is also preferable over trying to get the inheritance reversed in the common event types, as the `/sync` endpoint has a high amount of reliance on partial events definitions.
6 years ago
500f3d3bf1
Clarify that the default s2s transport is JSON over HTTP
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1713
6 years ago
a19eb59f13
Clarify the key object definition for the key management API
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1907
One too far
6 years ago
7ce1ff2135
Clarify which servers are supposed to sign events
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2074
6 years ago
a6314df44c
Spec v5 rooms: Key validity
...
Proposals:
* [MSC2076](https://github.com/matrix-org/matrix-doc/pull/2076 )
* [MSC2077](https://github.com/matrix-org/matrix-doc/pull/2077 )
Implementation references:
* 00bf99fa62https://github.com/matrix-org/synapse/pull/5354
* https://github.com/matrix-org/synapse/pull/5321
No known differences from the proposals are included here - alterations are accidental.
6 years ago
9ac89cc915
Merge pull request #2056 from matrix-org/travis/1.0/membership-table
...
Add a table to show how changes in membership should be interpreted
6 years ago
aa110b2be2
Merge pull request #2025 from matrix-org/travis/1.0/3rdpartysigned
...
Fix third party signed definitions for join APIs
6 years ago
e8d6a57a2e
Merge pull request #2052 from matrix-org/travis/1.0/pushrules-kind
...
Change reference for definition of push rule condition kinds
6 years ago
a3364ff357
Spec SAS verification and the common key verification framework
...
Reference implementations:
* 94f664e725https://github.com/matrix-org/matrix-react-sdk/pull/2461
* https://github.com/matrix-org/matrix-js-sdk/pull/818
* https://github.com/matrix-org/matrix-react-sdk/pull/2596
* https://github.com/matrix-org/matrix-js-sdk/pull/837
Proposals:
* [MSC1717](https://github.com/matrix-org/matrix-doc/pull/1717 )
* [MSC1267](https://github.com/matrix-org/matrix-doc/issues/1267 )
No alterations to either proposal have been made intentionally here.
6 years ago
9cb60fa468
Merge pull request #2059 from matrix-org/travis/1.0/msc1719-olm-unwedge
...
Add Olm unwedging
6 years ago
9dd171a718
Merge pull request #2069 from matrix-org/bwindels/messages-chunk-order
...
Clarify the order events in chunk are returned in for /messages
6 years ago
042455d954
Update changelog to appease style guidelines
6 years ago
8b28972a2d
PR feedback
6 years ago
010757c01d
Merge pull request #2057 from matrix-org/anoa/clarify_email_sending
...
Clarify what the client should receiving on email resending
6 years ago
49b9bfc9f6
Move changelog to the right place
6 years ago
1f86e8e31b
Refactor documentation for content/media repository
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2060
Fixes https://github.com/matrix-org/matrix-doc/issues/772
Fixes https://github.com/matrix-org/matrix-doc/issues/888
6 years ago
7a07a6b358
Clarify exactly what StrippedState is
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2066
The expectation everywhere is that the `sender` is required. `/initialSync` references StrippedState through a `m.room.member` event reference, and does not need editing.
6 years ago
d7f37f92eb
Merge branch 'master' into travis/1.0/fix-examples
6 years ago
ff768ec75f
Merge pull request #2036 from matrix-org/travis/1.0/wk-fail-error
...
Clarify that FAIL_ERROR is not limited to just homeservers.
6 years ago
54f74cd877
Add Olm unwedging
...
As per [MSC1719](https://github.com/matrix-org/matrix-doc/pull/1719 )
No known alterations have been made to the proposal.
Implementation proof: https://github.com/matrix-org/matrix-js-sdk/pull/780
6 years ago
9d7289f4f2
Merge pull request #2049 from matrix-org/travis/1.0/store-invite-params
...
Add missing aesthetic parameters to /store-invite
6 years ago
a2f955b50d
Merge pull request #2053 from matrix-org/travis/1.0/required-urls
...
Make url required for m.file-like messages
6 years ago
ff33b470a4
Merge pull request #2039 from matrix-org/travis/1.0/more-changelogs
...
Fix more changelog entries
6 years ago
dda8976d25
Add changelog
6 years ago
f3c0c5232f
Add a table to show how changes in membership should be interpreted
...
Fixes https://github.com/matrix-org/matrix-doc/issues/876
6 years ago
2ed37f5bf4
Clarify guest accounts and `auth` usage on /register
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1980
Fixes https://github.com/matrix-org/matrix-doc/issues/1984
6 years ago
0f623113f1
Clarify that UIA stages cannot be attempted twice
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1987
Note: Synapse currently does not care, however the spirit of the text in the spec implies that completed == done forever, so we're just reinforcing it here.
6 years ago
464845feb0
Make url required for m.file-like messages
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2008
This also removes `filename` from `m.file` because it has never been used in practice.
6 years ago
792bb8faa4
Renumber changelog to match PR
6 years ago
f9472bae41
Change reference for definition of push rule condition kinds
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1970
6 years ago
d2232aca97
Merge pull request #2042 from matrix-org/travis/1.0/ordered-flows
...
Clarify that login flows must be completed in order
6 years ago
c25afa663e
Use consistent event examples throughout the Client-Server API
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1968
6 years ago
15b8011f63
Add missing aesthetic parameters to /store-invite
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2048
6 years ago
4452ebf371
Merge pull request #2041 from matrix-org/travis/1.0/upload-mime-example
...
Fix example Content-Type for /media/upload request
6 years ago
0463084924
Spec 3PID unbind API
...
As per [MSC1915](https://github.com/matrix-org/matrix-doc/pull/1915 )
Implementation proof:
* https://github.com/matrix-org/synapse/pull/4982
* https://github.com/matrix-org/sydent/pull/160
The only alteration made which differs from the proposal is clarity on how to handle homeservers not knowing the `id_server`. All other differences are unintentional.
6 years ago
76829ad988
Merge pull request #2037 from matrix-org/travis/1.0/appservice-hs-token
...
Clarify how homeservers are meant to auth themselves to appservices
6 years ago
a8f61697d1
Merge pull request #2032 from matrix-org/travis/1.0/redaction-effects
...
Clarify how redactions affect room state
6 years ago
2cf00fc5ca
Merge pull request #2031 from matrix-org/travis/1.0/voip-hangup
...
Add missing reason property to m.call.hangup
6 years ago
bf86b4b83c
Fix incorrect PR reference on changelog
6 years ago
4e58414b26
Clarify that clients should not ack their own messages
...
Fixes https://github.com/matrix-org/matrix-doc/issues/567
6 years ago
Andrew Morgan