Travis Ralston
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
Travis Ralston
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
Travis Ralston
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
Travis Ralston
d6d74c4cbe
Switch to using $ instead of # for sub-types
...
# is reserved by the swagger validator as a way to include partial content from a JSON object (eg: "#/path" would include {"test": true} from the object {"path":{"test":true}}). Instead of trying to convince the validator that it is wrong, we'll just use a different character.
Note that our rendering tools do not care about #-style references to objects. It's still somewhat worth changing the character though.
6 years ago
Travis Ralston
2cf00fc5ca
Merge pull request #2031 from matrix-org/travis/1.0/voip-hangup
...
Add missing reason property to m.call.hangup
6 years ago
Travis Ralston
229893589a
Move wording for reason definitions
6 years ago
Travis Ralston
00f97636a2
Add missing reason property to m.call.hangup
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1689
6 years ago
Travis Ralston
5eea4a477f
Add server notices support
...
As per [MSC1452](https://github.com/matrix-org/matrix-doc/issues/1452 )
Fixes https://github.com/matrix-org/matrix-doc/issues/1254
Although MSC1452 focuses on just the warnings part of the server notices, the base for notices has not been established in the spec. This commit adds the needed support to be able to handle notices.
No intentional divergences from the proposal are included in this changeset. There are a few additions which are used in practice although not defined in the proposal, such as who is responsible for aesthetics, sending notices, and other misc rules.
6 years ago
Jonas Platte
043dddc490
Fix a typo in m.call.invite
6 years ago
Anatoly Sablin
4bec3d6dd8
Avoid duplicates.
6 years ago
Anatoly Sablin
d4b4d92b82
Fix the m.push_rules type (switch from the state event to the common event).
6 years ago
Anatoly Sablin
2de7ef9a3d
#1865 Add the m.push_rules schema.
6 years ago
Travis Ralston
b85f7bb248
Add room version upgrades
...
Implements https://github.com/matrix-org/matrix-doc/issues/1501
6 years ago
Travis Ralston
1268b421ec
Update the m.presence schema to include status_msg
6 years ago
Travis Ralston
f78bb72be8
Add status_msg to m.presence example
6 years ago
Travis Ralston
e4a8fed0e8
Power levels always have a default of 50 for state_default
...
As per the proposal https://github.com/matrix-org/matrix-doc/issues/1304
6 years ago
Konstantinos Sideris
192a6c2ab9
Use example.org on examples instead of domain.com which is a real domain
...
Signed-off-by: Konstantinos Sideris <sideris.konstantin@gmail.com>
6 years ago
Travis Ralston
108c623557
Merge pull request #1635 from turt2live/travis/c2s/read-markers
...
Add read markers
6 years ago
Hubert Chathi
c0dd7e0025
Merge pull request #1420 from Zil0/encrypted_attach
...
Document encrypted attachments
6 years ago
Hubert Chathi
f1f32d3a15
add more clarifications
6 years ago
Travis Ralston
679ddabb53
Merge remote-tracking branch 'matrix-org/master' into travis/c2s/read-markers
6 years ago
Hubert Chathi
e3daf10bb9
refactor encrypted file schema as "Extension to m.message"
6 years ago
Travis Ralston
fc037b3a72
Fix merge
6 years ago
Travis Ralston
2e3e189ea2
Merge remote matrix-org/master
6 years ago
Travis Ralston
afa16f1e4e
Merge pull request #1606 from turt2live/travis/c2s/room-tags
...
Update the room tagging documentation
6 years ago
Travis Ralston
f923d08078
Add read markers
...
This is the spec for https://github.com/matrix-org/matrix-doc/issues/910
Fixes https://github.com/matrix-org/matrix-doc/issues/910
Some reverse engineering was required to work out the complete details as to how this works. In particular, the 405 for setting account data and the behaviour of m.read.
References:
* 405 for account data: d69decd5c7/synapse/rest/client/v2_alpha/account_data.py (L85-L90)
* m.read behaviour: d69decd5c7/synapse/rest/client/v2_alpha/read_marker.py (L45-L52)
6 years ago
Travis Ralston
429f302744
Add an `age` to the invite room state example
6 years ago
Travis Ralston
464f4f5f21
Correctly check for the 'core' folder
6 years ago
Travis Ralston
c8a8f13623
Don't check the underlying definitions
...
Otherwise the script will try to find a schema for our templates, which don't exist.
6 years ago
Travis Ralston
31ea4279d1
Resolve references in the check_examples script
6 years ago
Travis Ralston
6aacec3178
Fix power level JSON example
6 years ago
Travis Ralston
827033c128
Merge remote matrix-org/master
6 years ago
Travis Ralston
fd7cb22a28
Fix event type example of m.forwarded_room_key
6 years ago
Hubert Chathi
4230e375fa
Merge pull request #1465 from Zil0/key_sharing
...
Document key sharing events
6 years ago
Travis Ralston
c03f2f8d79
Minor touchups to the room tagging API
...
Fixes some of https://github.com/matrix-org/matrix-doc/issues/1565
6 years ago
Kitsune Ral
9bc1470305
Elaborate the structure of m.tag events
...
...and corresponding structures in tag-related CS API calls
Signed-off-by: Alexey Rusakov <Alexey.Rusakov@pm.me>
6 years ago
Travis Ralston
c83da453b5
s/number/integer
6 years ago
Travis Ralston
26d5a24b88
Merge remote matrix-org/master
6 years ago
Travis Ralston
62b1b8b660
Have unsigned.age appear on all room events
...
This is useful for a lot of things, like bridges (appservices), VoIP handling, and clients which generally may wish to do something with the field. Might as well include it on every event, despite the recommendation of https://github.com/matrix-org/matrix-doc/issues/1524
6 years ago
Travis Ralston
c297c6a35d
Update schemas and auth rules to cover the @ state key restriction
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1305
Also fixes an issue regarding the `_` being restricted previously, which is false.
6 years ago
Travis Ralston
ee3b0f42db
Fix server ACL schema: The type is a string
...
It cannot be an enum otherwise the build starts screaming.
6 years ago
Travis Ralston
6cdb463829
Merge pull request #1571 from turt2live/travis/general/number-to-int
...
Replace applicable types of 'number' to 'integer'
6 years ago
Valentin Deniaud
28ced3b0a4
fixup! document encrypted attachments
6 years ago
Travis Ralston
8e42f3ab3a
Fix bad merge on brackets
6 years ago
Travis Ralston
4b05194a91
Fix bad merge
6 years ago
Travis Ralston
4278a9a516
Merge remote-tracking branch 'matrix-org/master' into travis/c2s/fix-events
6 years ago
Travis Ralston
e4f8c23972
Merge pull request #1562 from turt2live/travis/c2s/html-formatting
...
Define the supported HTML subset for message events
6 years ago
Travis Ralston
efef3412a0
Take out the underscore restriction from state events
...
It's not needed anymore, and we should remove it while we're in the area.
Includes other misc changes to the schema layout.
6 years ago
Travis Ralston
439b9d2925
Power levels are also integers
6 years ago
Travis Ralston
ee2ebe6792
Merge pull request #1568 from turt2live/travis/c2s/invite-room-state
...
Move `invite_room_state` to the correct place in the client-server API
6 years ago
Travis Ralston
4e885c3f77
Merge pull request #1550 from turt2live/travis/general/acls
...
Server ACLs
6 years ago
Matthew Hodgson
313e6de48b
tweak wording to spell out that handling legacy/noncompliant servers.
6 years ago
Travis Ralston
76afef79f8
Clarify the rationale and motive for blanket IP banning and port exclusion
6 years ago
Travis Ralston
82be6077ff
Add a note that ACLs don't operate at the auth level; Fix glob definition
6 years ago
Travis Ralston
be2e0fc9d4
Clarify that ACLs are required to manually deny unsupported hosts
6 years ago
Travis Ralston
72de8bec5c
Remove unused algorithms for encrypted messages
6 years ago
Travis Ralston
438f5825ae
Add more supported encryption algorithms to message events
6 years ago
Travis Ralston
17bdc0c740
Revert "Fix encrypted event examples"
...
This reverts commit be9f6042e5
.
6 years ago
Travis Ralston
55c0b968b5
Fix event schemas for /sync
...
This commit clarifies the required keys for each type of event that appears in sync, fixes the core event schema not declaring 'content' as required, and includes a mention that events may not have a room_id when appearing in /sync.
Fixes https://github.com/matrix-org/matrix-doc/issues/595
Fixes https://github.com/matrix-org/matrix-doc/issues/909
6 years ago
Travis Ralston
667fa082af
Replace applicable types of 'number' to 'integer'
...
`number` implies/represents a float where `integer` does not.
The only remaining `type: number` in the project appear on power levels: those have been left untouched pending clarification.
Fixes https://github.com/matrix-org/matrix-doc/issues/746
6 years ago
Travis Ralston
e9e93b0eec
Move `invite_room_state` to the correct place in the client-server API
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1350
6 years ago
Travis Ralston
be9f6042e5
Fix encrypted event examples
6 years ago
Travis Ralston
e5a7dd1c45
Remove excess commas from JSON
6 years ago
Travis Ralston
aa294fac06
Define the supported HTML subset for message events
...
Also clarify that `m.notice` messages can support HTML.
Fixes https://github.com/matrix-org/matrix-doc/issues/1559
Fixes https://github.com/matrix-org/matrix-doc/issues/1560
6 years ago
Travis Ralston
295b1322e2
Add back the unsigned.age property to voip event examples
6 years ago
Valentin Deniaud
b7577ea237
document encrypted attachments
...
Fix #461 .
6 years ago
Valentin Deniaud
579f5ea928
fixup! document key sharing and m.room_key_request
6 years ago
Valentin Deniaud
8ae137e82e
fixup! document m.forwarded_room_key
6 years ago
Valentin Deniaud
768f33dc2d
fixup! document key sharing and m.room_key_request
6 years ago
Valentin Deniaud
337316445f
fixup! document m.forwarded_room_key
6 years ago
Travis Ralston
0f28f83270
Fix client-server event schemas: remove `age`, dedupe fields
...
This commit adds support for event schema examples to have references to help reduce the chance of fields being forgotten. This also helps reduce duplication of fields, allowing for a more consistent spec that uses the same values everywhere.
This also removes both `unsigned` and `age` from the examples as per:
* https://github.com/matrix-org/matrix-doc/issues/1524
* https://github.com/matrix-org/matrix-doc/issues/630
Finally, this replaces "localhost" in the examples with an example domain. This is really just a nitpick thing on my part where seeing a "real world" domain is preferred.
Fixes https://github.com/matrix-org/matrix-doc/issues/1524
Fixes https://github.com/matrix-org/matrix-doc/issues/630
Step towards https://github.com/matrix-org/matrix-doc/issues/1530
6 years ago
Travis Ralston
ef41b5c2bf
Server ACLs
...
Implements the proposal for https://github.com/matrix-org/matrix-doc/issues/1383
6 years ago
Valentin Deniaud
019c290fa2
document m.forwarded_room_key
6 years ago
Valentin Deniaud
2d8a321b46
document key sharing and m.room_key_request
6 years ago
Travis Ralston
3869f68a5c
Merge remote-tracking branch 'matrix-org/master' into travis/general/room-versions
6 years ago
Valentin Deniaud
f853856f21
add missing m.room.encrypted event properties
6 years ago
Valentin Deniaud
6c44233c42
require megolm algorithm in m.room.encryption
6 years ago
Valentin Deniaud
661176cb3a
Olm m.room.encrypted example
6 years ago
Valentin Deniaud
8732378da2
add required room ids
6 years ago
Valentin Deniaud
c60109d235
complete m.room_key documentation
6 years ago
Valentin Deniaud
3a8d13df60
add missing m.room.encryption properties
6 years ago
Valentin Deniaud
e5005b2d0f
document E2E events
...
This was written by Richard van der Hoff.
6 years ago
Michael Telatynski
57571ea4ce
Merge branch 'master' of github.com:matrix-org/matrix-doc into notifications/room
6 years ago
Travis Ralston
fde48e7ee8
Specify how room versioning works
...
This is the spec PR for https://github.com/matrix-org/matrix-doc/issues/1425
Room version upgrades are not part of MSC1425.
Documented aspects:
* room_version on the create event
* creating a room with a specific version (useful for testing)
* make_join behaviour
* error code documentation
* grammar of room versions
Based upon https://docs.google.com/document/d/1urKgReoHqxX8R_XtySB17dPi-DZcKhqTEL2_s895Wz0/edit
6 years ago
Travis Ralston
55e4e90ab1
Document message formats as-is
...
This is likely to later be replaced by mixins, however this is being documented now so clients aren't left in the dark.
Fixes https://github.com/matrix-org/matrix-doc/issues/917
6 years ago
Michael Telatynski
992bc8828a
Merge branches 'master' and 'notifications/room' of github.com:matrix-org/matrix-doc into notifications/room
7 years ago
Michael Telatynski
c305317fa5
explicitly specify @room
7 years ago
Michael Telatynski
60ae73b179
specify default
7 years ago
Michael Telatynski
1e656d836e
spec notifications key on power level event and provide @room in example
7 years ago
Richard Lewis
8d05f80cec
Sticker messages (m.sticker) ( #1158 )
7 years ago
Travis Ralston
6e7d264bc7
Add clarity to the m.ignored_user_list
...
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
0835612277
Represent the ignored users event correctly
...
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
af74790681
Merge remote-tracking branch 'matrix-org/master' into travis/m.ignored_user_list
7 years ago
Travis Ralston
331e49bd0d
Improve the documentation of ignored users
...
* Fix the event schema to represent the real world
* Add the module to the spec targets
* Remove incomplete thought from the client behaviour
* Link to the account data API
* Minor word choice changes
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
eb8c3255bf
Remove extraneous comma from m.presence schema
...
This causes the build to fail. Fixes #1146
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
d37ed0876f
Merge branch 'master' into travis/m.ignored_user_list
7 years ago
Richard van der Hoff
a0dda3cae2
Merge branch 'master' into travis/m.tag
7 years ago
Travis Ralston
e862ef60ae
Spec ignoring users
...
Adds https://github.com/matrix-org/matrix-doc/issues/528
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
a3f006353c
Tag ordering is defined as a number between 0 and 1, not strings
...
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Travis Ralston
a488bd5503
Make m.presence match what synapse returns
...
Considering this is the behaviour that is embedded into most client libraries and the most popular homeserver, it should be adopted as the standard.
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago