Travis Ralston
78487a01ec
Remove references to initialSync from account data and receipts module
...
Fixes https://github.com/matrix-org/matrix-doc/issues/695
Note: This commit leaves the /join endpoints alone because they say "and /sync" rather than just initialSync
6 years ago
Travis Ralston
e227095fb4
Add rich replies
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1234
The notable parts of this are:
* The titles go to insane levels. Rich replies are fairly complex and need some splitting apart to be understandable.
* The allowed HTML tags now have an exception for `<mx-reply>`
Please note that the event example is intended to be fixed by a PR that fixes all event examples.
6 years ago
Hubert Chathi
4230e375fa
Merge pull request #1465 from Zil0/key_sharing
...
Document key sharing events
6 years ago
Hubert Chathi
0130620cc1
Merge pull request #1596 from uhoreg/e2e_sessions
...
specify how to handle multiple olm sessions with the same device
6 years ago
Travis Ralston
2ab2f91088
Merge remote-tracking branch 'matrix-org/master' into travis/releases/push-gateway/r0.1.0
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
Travis Ralston
2234e0b097
Mention that clients should not be producing invalid HTML
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1595
6 years ago
Matthew Hodgson
8e88d82a4b
fix typo in anchor. fixes #1603
6 years ago
Travis Ralston
ec20c43220
Specify the minimum CSP for media
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1066
6 years ago
Travis Ralston
39ef845a53
Merge pull request #1547 from turt2live/travis/c2s/pills
...
Document how mentions (pills) work
6 years ago
Hubert Chathi
688c8ebcd3
specify how to handle multiple olm sessions with the same device
6 years ago
Valentin Deniaud
28ced3b0a4
fixup! document encrypted attachments
6 years ago
Travis Ralston
72c6fa2aaf
More versioned links
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
fa3e9a7609
Merge remote-tracking branch 'matrix-org/master' into travis/c2s/pills
6 years ago
Travis Ralston
4e885c3f77
Merge pull request #1550 from turt2live/travis/general/acls
...
Server ACLs
6 years ago
Travis Ralston
bac0392a2d
General clarity for push rule defaults and where to get information
...
Include moving a roaming condition that was under the wrong rule.
6 years ago
Travis Ralston
d7397ccd56
Provide additional rationale for kicking users when they are ACLd
6 years ago
Travis Ralston
76afef79f8
Clarify the rationale and motive for blanket IP banning and port exclusion
6 years ago
Travis Ralston
89daa3c5ce
Clarify that clients aren't required to render all the tags
...
This commit also includes minor clarifications to surrounding text.
6 years ago
Travis Ralston
5bf99aeb34
Add a note that formatted_body is not forever
6 years ago
Travis Ralston
c7822cc9a8
Link to the content repo when referencing MXC URIs in images
6 years ago
Travis Ralston
d7d28f7e5b
Remove nl as a supported HTML tag
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
312799ae78
General clarification for mention and how matrix.to URIs are meant to work
6 years ago
Valentin Deniaud
b7577ea237
document encrypted attachments
...
Fix #461 .
6 years ago
Valentin Deniaud
f6b5aee3e2
explain how to use key sharing events
6 years ago
Travis Ralston
ab0be04571
Fix titles
6 years ago
Travis Ralston
7ec3cc4343
General improvements to the push rules module
...
This commit does a few things:
* Add 3 undocumented push rules to the spec for encrypted events and at-room notifications.
* Require unrecognized conditions to not match, ensuring that future conditions do not cause clients to accidentally notify users.
* Clarify that push rules should be enabled when created.
* Document a new condition required for at-room notifications.
Fixes https://github.com/matrix-org/matrix-doc/issues/1163
Fixes https://github.com/matrix-org/matrix-doc/issues/1034
Fixes https://github.com/matrix-org/matrix-doc/issues/676
Fixes https://github.com/matrix-org/matrix-doc/issues/1033
Relates to https://github.com/matrix-org/matrix-doc/issues/1101
6 years ago
Travis Ralston
ef41b5c2bf
Server ACLs
...
Implements the proposal for https://github.com/matrix-org/matrix-doc/issues/1383
6 years ago
Travis Ralston
9835c98544
Document how mentions (pills) work
...
Implements the proposal over at https://github.com/matrix-org/matrix-doc/issues/1067
Includes some specification for how matrix.to is structured, and how it is intended to be replaced.
6 years ago
Valentin Deniaud
2d8a321b46
document key sharing and m.room_key_request
6 years ago
Will Hunt
fca1c0b7f8
Guests should support /context and /event
6 years ago
Valentin Deniaud
9430f2c7f9
room ID is included in Megolm plaintext, not Olm
6 years ago
Valentin Deniaud
8ba19b51ab
complete Olm documentation
6 years ago
Valentin Deniaud
b2316ba782
enforce unique namespacing in new algorithms experiments
6 years ago
Valentin Deniaud
eb8ea0e85a
remove warning pointing at outdated doc
6 years ago
Valentin Deniaud
4e0f107ef7
document changed field behavior in e2e sync extension
6 years ago
Valentin Deniaud
248786681e
fix typo
6 years ago
Valentin Deniaud
e5005b2d0f
document E2E events
...
This was written by Richard van der Hoff.
6 years ago
Valentin Deniaud
68b78dc5d8
complete Megolm documentation
6 years ago
Valentin Deniaud
669605b24a
add Olm missing properties
6 years ago
Valentin Deniaud
76071bae98
explain how to verify sender_key ownership
6 years ago
Valentin Deniaud
8274f91b0b
document device verification
...
This was written by Richard van der Hoff.
6 years ago
Valentin Deniaud
a28f243ed7
document left parameter of device_lists in sync response
...
fix #1171
6 years ago
Valentin Deniaud
10c3307427
document device_one_time_keys_count in /sync/ response
...
fix #1157
6 years ago
Valentin Deniaud
2686b99080
fix json indent
6 years ago
Valentin Deniaud
07e3de3c61
add megolm messaging algorithm subsection
...
This was written by Richard van der Hoff.
6 years ago
Valentin Deniaud
33802dbbaf
add olm messaging algorithm subsection
...
This was written by Richard van der Hoff.
6 years ago
Valentin Deniaud
e210f8b050
add e2e messaging algorithms section intro
...
This was written by Richard van der Hoff.
6 years ago
Travis Ralston
4b9922b641
Merge pull request #1494 from turt2live/travis/general/openid
...
Document OpenID in the client-server and server-server APIs
6 years ago
Travis Ralston
de961fb7d6
Improve wording on push gateways
6 years ago
Travis Ralston
6ad71f785e
Improve documentation for pushers and push gateways
...
This fixes a number of formatting issues alongside a few documentation problems:
* The push gateway can actually expect less parameters than previously advertised. This is for user privacy.
* Introduction of the `m.email` pusher for email-capable homeservers.
* Fields not being flagged as required on some endpoints.
* Document the `event_id_only` format
Note: this does not attempt to document push rules, just pushers.
Fixes https://github.com/matrix-org/matrix-doc/issues/1374
Fixes https://github.com/matrix-org/matrix-doc/issues/1087
6 years ago
Travis Ralston
88b35d1be5
Clarify how third party invites work
...
This adds several diagrams to the Client-Server API about how invites
are handled, including what the server is expected to do. This helps
implementors know what they are supposed to do in the common cases,
and infer where needed to get the more complex cases correct.
Although lacking in some areas, this is how third party invites work
today.
A link to the now-improved client-server documentation for third party
invites has been added to the server-server specification. The existing
server-server specification needed no further changes on the subject.
Fixes https://github.com/matrix-org/matrix-doc/issues/1366
6 years ago
Travis Ralston
8ffac01efe
Document OpenID in the client-server API
...
Part of https://github.com/matrix-org/matrix-doc/issues/857
Reference: d69decd5c7/synapse/rest/client/v2_alpha/openid.py (L31-L58)
6 years ago
David Baker
803ef536ba
Fix grammar in room tag spec
...
Have removed the second clause about how the client interprets them:
I was trying to think how to rephrase it but I think in reality it's
probably just redundant.
6 years ago
David Baker
2dc51d416d
Ignore stuff in `m.` you don't understand
6 years ago
David Baker
f90ed4b77d
Make non-namespaced tags verboten
6 years ago
David Baker
e4fd088fcc
Fix room tags spec
6 years ago
Ben Parsons
07aeaadef9
update links which used to point to docs/spec/intro
6 years ago
Andrew Morgan
291a4dfc76
Third party lookup module. Fix wording
6 years ago
Andrew Morgan
114bcf1a2e
Use $ref, clean up, fix errors, AS is now a C-S module.
6 years ago
Travis Ralston
9037f506ac
Document how to report content
...
Fixes: https://github.com/matrix-org/matrix-doc/issues/739
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Jason Volk
2a6895e759
Fix typo.
7 years ago
Jason Volk
2802fdea7e
Fix typo.
7 years ago
Richard Lewis
8d05f80cec
Sticker messages (m.sticker) ( #1158 )
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
d37ed0876f
Merge branch 'master' into travis/m.ignored_user_list
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
Florian Jacob
ac861d9b97
Correct CAS spec link
...
Signed-off-by: Florian Jacob <projects+git AT florianjacob )DOT( de>
7 years ago
Victor Berger
cc8128edad
Specify namespaces for tags
...
This is a proposition for closing #931 .
This should be a fairly uncontroversial addition (apart from bike-shedding), which only defines behavior for clients that want use tags or expose tagging functionality to their users.
The idea of adding this to the spec is to ensure clients can peacefully share the tag namespace without conflicting with each other, using rules similar to namespaces for state keys.
7 years ago
Travis Ralston
5e7df0e87c
Update instant_messaging.rst
...
Signed-off-by: Travis Ralston <travpc@gmail.com>
7 years ago
Richard van der Hoff
da6938b818
Key management APIs ( #894 )
...
Spec the e2e key-management APIs.
8 years ago
Richard van der Hoff
5537f7a832
Allow guest access to E2E endpoints
8 years ago
Richard van der Hoff
4abdcc6f05
Merge pull request #402 from matrix-org/rav/device_management
...
Device management API
8 years ago
Richard van der Hoff
461bfdb0d8
Merge branch 'master' into rav/device_management
8 years ago
Mark Haines
7025793ca8
Say that thumbnails should be 'mxc://'
8 years ago
David Baker
41f4661d1b
Fix API path in pushrules examples
8 years ago
Richard van der Hoff
af515012ea
Device management API
8 years ago
Richard van der Hoff
42616f839c
Merge pull request #396 from matrix-org/dbkr/notifs_api
...
Spec notifs API
8 years ago
Richard van der Hoff
909aef2b18
Merge pull request #389 from matrix-org/erikj/create_room_is_direct
...
Spec /createRoom is_direct flag, is_direct in member event and m.direct
8 years ago
Richard van der Hoff
83b89aa1ce
dm: clarify client behaviour
8 years ago
David Baker
ed2d364440
consistency
8 years ago
David Baker
96b6fb0129
'In the m.room.member' event
8 years ago
David Baker
301595c071
Linkify account_data API
...
Also change other links because it turns out the .. isn't part
of the syntax
8 years ago
David Baker
2a987c3369
Linkify endpoints properly
8 years ago
David Baker
2259a00ba2
links
8 years ago
David Baker
3f66ba713c
Reference m.room.member section
8 years ago
David Baker
e2024e5829
Add note on how to use the account data event
8 years ago
David Baker
d791f35007
Remove unnecessary paragraph
8 years ago
David Baker
4480553bf9
Move m.direct description to the swagger
...
Also change the swagger to yaml so I can put that description in it
without having to figure out how to embed that in json.
8 years ago
David Baker
c16ba9488f
Spec notifs API
8 years ago
David Baker
8e096bdc48
Link to createRoom, not initialsync
8 years ago
David Baker
85bc989c02
pr feedback
8 years ago
David Baker
976d41351e
spelling
8 years ago
David Baker
d39f662df5
PR feedback
8 years ago
David Baker
203ea99328
Spec m.direct
8 years ago
Richard van der Hoff
ebaaa7e3b3
Review feedback
...
* store-and-forward -> send-to-device
* describe motivation
* device ids are 10 capital chars
* etc
8 years ago
Richard van der Hoff
ccd7bb32d5
Specification for direct-to-device messages
8 years ago
David Baker
9a1db01d92
Clarify `highlight` and `sound` tweaks.
8 years ago
David Baker
fd888fcbda
Merge pull request #373 from matrix-org/dbkr/contains_display_name_override
...
Make the display name rule an override rule
8 years ago
David Baker
b65b0d049e
Make the display name rule an override rule
8 years ago
David Baker
6592646ee9
Add dot prefix to .rule.master
...
It's a default rule, so it needs a dot
8 years ago
Richard van der Hoff
1f1dfdd91c
More clarifications
8 years ago
Richard van der Hoff
ec81b4c9fe
More PR feedback
...
Add a couple of TODO sections
8 years ago
Richard van der Hoff
4b0e546eeb
PR feedback
...
Fix some typos, and clarify several aspects of server behaviour.
8 years ago
Richard van der Hoff
41368dc5a7
document CAS login
...
Following the spirit of "document how it is, not how we wish it was", document
the CAS login bits.
8 years ago
Richard van der Hoff
49cd65dd58
Add a license to the spec
...
We're licensing hte spec under ASLv2. Add the LICENSE file, and add the
short-form to as much of the source as is practical right now (adding it to
json source is a massive pita).
8 years ago
Richard van der Hoff
885e6797f2
Fix double-negative in room naming
8 years ago
Richard van der Hoff
7b4c21fa77
Add link to room name bug
8 years ago
Richard van der Hoff
d4194dd24e
Clarify the room-naming behaviour
...
Make behaviour on empty `m.room.name` and `m.room.canonical_alias` events
explicit.
8 years ago
Richard van der Hoff
df3f4b4ecf
Fix link to draft e2e spec
9 years ago
Mark Haines
af091ff614
Document changes to the default push rules
9 years ago
Mark Haines
30a3302921
Merge pull request #274 from matrix-org/markjh/default_rules
...
Update the predefined push rules in the spec
9 years ago
Erik Johnston
e80e32173f
Merge pull request #278 from matrix-org/erikj/presence
...
Update presence spec.
9 years ago
Richard van der Hoff
b59d16c4d1
Clarify `history_visibility` behaviour
...
Clear up some lies in the history_visibility section, and clarify behaviour for
`m.room.history_visibility` and the user's own `m.room.member` events.
9 years ago
Kegsay
506accee27
Merge pull request #288 from matrix-org/markjh/pushrule_stream
...
Add a snippet of documentation for a m.push_rules event.
9 years ago
Daniel Wagner-Hall
f4f186baee
Add _cs suffix to client-server http APIs
...
I'm about to add identity service APIs, so differentiating is good.
9 years ago
Mark Haines
c3c95d0c09
Fix grammar and add backticks for /sync
9 years ago
Mark Haines
5407cc8e05
Add a snippet of documentation for a m.push_rules event.
9 years ago
Erik Johnston
3d4d91a462
Reword to make sense
9 years ago
Erik Johnston
167a08a805
Allow idle timeout to be configurable
9 years ago
Erik Johnston
bc68177471
Grammar
9 years ago
Erik Johnston
f1a8306d08
Spec currently_active time and idle timeout behaviour
9 years ago
Richard van der Hoff
68a4306773
Split room previews into a separate module
...
Guest access and room peeking are orthogonal
9 years ago
Mark Haines
740f775932
Fix a couple of typos, remove .m.rule.member_event
9 years ago
Mark Haines
3db6980e0b
Remove references to device specific push rules
...
Since they weren't implemented on the servers and weren't
used by the clients.
9 years ago
Mark Haines
5d85e3a505
Remove indents
9 years ago
Mark Haines
b16af5ef64
Fix JSON, add headers
9 years ago
Mark Haines
8a1a02a11b
Update the predefined push rules in the spec
9 years ago
Matthew Hodgson
6925547875
remove the oversimplification that the WebRTC standard is based around two-oparty communication
9 years ago
Richard van der Hoff
b2e0a855cc
Add 'event' to event context API
...
also link through to the event schemas
9 years ago
Richard van der Hoff
cff1b4ae35
Merge pull request #251 from matrix-org/daniel/guestshiz
...
Clarify guest /events and /sync
9 years ago
Daniel Wagner-Hall
3edff684a1
Merge pull request #253 from matrix-org/daniel/guestupgrade
...
Guests can upgrade to regular accounts
9 years ago
Daniel Wagner-Hall
7d9547274c
Clarify guest /events and /sync
9 years ago
Daniel Wagner-Hall
713415015b
Remove mention that /sync takes an inline filter
9 years ago
Daniel Wagner-Hall
d3f05ae49a
Guests can upgrade to regular accounts
9 years ago
Daniel Wagner-Hall
ca67aa7b4f
Tidy up guest access spec
...
* Mention that /leave is allowed
* Mention that /sync is allowed
* Re-order such that the whole list of APIs fits on one screen
9 years ago
Richard van der Hoff
e4dd346a81
Restore 'client behaviour' section
...
Because it's the standard
9 years ago
Richard van der Hoff
b7c255a887
Tweaks/clarifications to search spec
...
Fixes https://matrix.org/jira/browse/SPEC-305
9 years ago
Matthew Hodgson
f8f76794a3
fix random whitespace bug
9 years ago
Daniel Wagner-Hall
a484f04b33
Merge pull request #221 from matrix-org/daniel/pushaway
...
Merge pull request #221 from matrix-org/daniel/pushaway
9 years ago
Erik Johnston
c96848d1bc
Merge pull request #169 from matrix-org/erikj/search_yet_agian
...
Search: Document event context, groups and orders.
9 years ago
Daniel Wagner-Hall
a2283f5499
Remove /notify from client-server API
9 years ago
Erik Johnston
dd276d4c4d
Add event context module
9 years ago
Erik Johnston
856dd9100e
Merge remote-tracking branch 'origin/master' into erikj/search_yet_agian
9 years ago
Erik Johnston
2aef684e7e
Add list of required supported groupings
9 years ago
Erik Johnston
c61ae86102
Specify behaviour if server does not support pagination
9 years ago
Richard van der Hoff
3939ccf20c
Remove e2e drafts from master
...
This is now being tracked in the main spec, on the drafts/e2e branch.
9 years ago