Tidy up the specification

* Minor word choice changes
* Remove the now-empty "Protocol URLs" section
pull/977/head
Travis Ralston 6 years ago
parent 56dbeeb22a
commit 32178bb07e

@ -23,14 +23,13 @@ Federation API
Matrix homeservers use the Federation APIs (also known as server-server APIs) Matrix homeservers use the Federation APIs (also known as server-server APIs)
to communicate with each other. Homeservers use these APIs to push messages to to communicate with each other. Homeservers use these APIs to push messages to
each other in real-time, to each other in real-time, to retrieve historic messages from each other, and to
historic messages from each other, and to
query profile and presence information about users on each other's servers. query profile and presence information about users on each other's servers.
The APIs are implemented using HTTPS GETs and PUTs between each of the The APIs are implemented using HTTPS requests between each of the servers.
servers. These HTTPS requests are strongly authenticated using public key These HTTPS requests are strongly authenticated using public key signatures
signatures at the TLS transport layer and using public key signatures in at the TLS transport layer and using public key signatures in HTTP
HTTP Authorization headers at the HTTP layer. Authorization headers at the HTTP layer.
There are three main kinds of communication that occur between homeservers: There are three main kinds of communication that occur between homeservers:
@ -485,15 +484,9 @@ A *conflict* occurs between states where those states have different
``event_ids`` for the same ``(state_type, state_key)``. The events thus ``event_ids`` for the same ``(state_type, state_key)``. The events thus
affected are said to be *conflicting* events. affected are said to be *conflicting* events.
Protocol URLs
-------------
.. WARNING::
This section may be misleading or inaccurate.
All these URLs are name-spaced within a prefix of::
/_matrix/federation/v1/...
Joining Rooms Joining Rooms
------------- -------------

Loading…
Cancel
Save