docs-matrix-spec/content/rooms/v2.md
Travis Ralston d4c74d37a9
Update documentation style & fix room version heading order (#3683)
* Update documentation style & fix room version heading order

Also add a missing signing key section to v6.

This additionally contains various edits to the fragments to have them make a little bit more sense in context.

Finally, this updates various aspects of the documentation style which haven't previously been considered - they're added here considering we're in the area.

* changelog

* enhanced changelogs

* Minor wording adjustments

* Apply suggestions from code review

Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>

Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
2022-01-31 15:18:58 -07:00

1.3 KiB

title type weight
Room Version 2 docs 20

This room version builds on version 1 with an improved state resolution algorithm.

Client considerations

There are no client considerations introduced in this room version. Clients which implement the redaction algorithm locally should refer to the redactions section below for a full overview of the algorithm.

Server implementation components

{{% boxes/warning %}} The information contained in this section is strictly for server implementors. Applications which use the Client-Server API are generally unaffected by the details contained here, and can safely ignore their presence. {{% /boxes/warning %}}

Room version 2 uses the base components of room version 1, changing only the state resolution algorithm.

State resolution

{{% added-in this=true %}}

{{% rver-fragment name="v2-state-res" %}}

Unchanged from v1

The following sections have not been modified since v1, but are included for completeness.

Redactions

{{% rver-fragment name="v1-redactions" %}}

Event format

Events in rooms of this version have the following structure:

{{% definition path="api/server-server/definitions/pdu" %}}

Authorization rules

{{% rver-fragment name="v1-auth-rules" %}}

Canonical JSON

{{% rver-fragment name="v1-canonical-json" %}}