You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec/specification
Travis Ralston ffe577371d Add a room version specification
The "Room Specification" (or "Room Version Specification") is the specification that defines which room versions do what and are intended to be documents which speak the truth about how rooms operate under the hood.

The approach taken here is a bit different than other specifications. For starters, the specification is versioned in this project instead of relying on the matrix.org repository to track compiled HTML. This is done for a couple reasons, the first being we're still developing the v1 specification while concurrently making a v2 spec and the second being trying to reduce the reliance on matrix.org's repository for specifications.

Because the room spec is built into versions, some changes needed to be made. The `targets.yaml` now has a special syntax for indicating what version something is at, and the changelog generator can handle rendering different versions of the same changelog (as parsed from the RST). Some additional work has been put in to the changelog parsing to allow us to reference the v1 room spec as "v1" without having to sacrifice clarity in the changelog headings.

Finally, this moves the state resolution algorithms into the versioned
spec as a result of MSC1759 (https://github.com/matrix-org/matrix-doc/pull/1759).

Note: this does not introduce the concept of versioned schemas (tabs) that I was previously working with. There's currently no use for them, so they are shelved elsewhere.
6 years ago
..
appendices Add a room version specification 6 years ago
modules Merge pull request #1743 from matrix-org/dbkr/add_sandbox_to_csp 6 years ago
rooms Add a room version specification 6 years ago
appendices.rst Split appendices up 8 years ago
application_service_api.rst fix irc bridge example properly 6 years ago
client_server_api.rst Use example.org on examples instead of domain.com which is a real domain 6 years ago
events.rst fix inter-spec link 7 years ago
feature_profiles.rst Third party lookup module. Fix wording 6 years ago
identity_service_api.rst Add r0 version links 6 years ago
index.rst link to CS API Swagger Viewer 6 years ago
modules.rst Add a license to the spec 8 years ago
proposals.rst Use $ref, clean up, fix errors, AS is now a C-S module. 6 years ago
proposals_intro.rst Make the proposal labels match what happens in practice 6 years ago
push_gateway.rst Render a warning if the spec is unstable 6 years ago
server_server_api.rst Add a room version specification 6 years ago
targets.yaml Add a room version specification 6 years ago