Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Room v2 proposal #1759

Merged
merged 1 commit into from
Dec 23, 2018
Merged

Room v2 proposal #1759

merged 1 commit into from
Dec 23, 2018

Conversation

erikjohnston
Copy link
Member

@erikjohnston erikjohnston commented Dec 17, 2018

This MSC proposes adding a new room version to allow servers and users to opt into using the new state resolution algorithm. Given that this does not propose making the new room version the default, nor prompting users to upgrade existing rooms, I'm hoping that this should be relatively uncontroversial.

We do not propose to make this a new default as there are several other incompatible changes to rooms we wish to make, and so its probably best to wait for those to land before changing the default and prompting people to upgrade existing rooms.

This assumes that MSC #1693 lands.

Rendered

@erikjohnston erikjohnston added proposal-in-review proposal A matrix spec change proposal labels Dec 17, 2018
@erikjohnston
Copy link
Member Author

erikjohnston commented Dec 17, 2018

Given I hope this is uncontroversial, I'm going to straight up propose an FCP

@mscbot fcp merge

@turt2live
Copy link
Member

@mscbot fcp merge

@turt2live
Copy link
Member

3rd time's the charm?

@mscbot fcp merge

@mscbot
Copy link
Collaborator

mscbot commented Dec 17, 2018

Team member @turt2live has proposed to merge this. The next step is review by the rest of the tagged teams:

No concerns currently listed.

Once a majority of reviewers approve (and none object), this will enter its final comment period. If you spot a major issue that hasn't been raised at any point in this process, please speak up!

See this document for info about what commands tagged team members can give me.

@mscbot mscbot added proposed-final-comment-period Currently awaiting signoff of a majority of team members in order to enter the final comment period. disposition-merge labels Dec 17, 2018
@richvdh
Copy link
Member

richvdh commented Dec 17, 2018

A note largely for my own reference: this will use the room versioning APIs specified in #1516.

@erikjohnston
Copy link
Member Author

@mscbot reviewed

@mscbot mscbot added final-comment-period This MSC has entered a final comment period in interest to approval, postpone, or delete in 5 days. and removed proposed-final-comment-period Currently awaiting signoff of a majority of team members in order to enter the final comment period. labels Dec 18, 2018
@mscbot
Copy link
Collaborator

mscbot commented Dec 18, 2018

🔔 This is now entering its final comment period, as per the review above. 🔔

@mscbot mscbot added finished-final-comment-period and removed final-comment-period This MSC has entered a final comment period in interest to approval, postpone, or delete in 5 days. labels Dec 23, 2018
@mscbot
Copy link
Collaborator

mscbot commented Dec 23, 2018

The final comment period, with a disposition to merge, as per the review above, is now complete.

@richvdh
Copy link
Member

richvdh commented Jan 3, 2019

implemented in matrix-org/synapse#4307

@richvdh richvdh added spec-pr-missing Proposal has been implemented and is being used in the wild but hasn't yet been added to the spec and removed T-Core disposition-merge finished-final-comment-period labels Jan 3, 2019
turt2live added a commit that referenced this pull request Jan 4, 2019
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 (#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.
@turt2live turt2live added the spec-pr-in-review A proposal which has been PR'd against the spec and is in review label Jan 4, 2019
@turt2live turt2live removed the spec-pr-missing Proposal has been implemented and is being used in the wild but hasn't yet been added to the spec label Jan 4, 2019
@turt2live turt2live added merged A proposal whose PR has merged into the spec! and removed spec-pr-in-review A proposal which has been PR'd against the spec and is in review labels Jan 24, 2019
@turt2live
Copy link
Member

Merged via #1773 🎉

@turt2live turt2live added the kind:core MSC which is critical to the protocol's success label Apr 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind:core MSC which is critical to the protocol's success merged A proposal whose PR has merged into the spec! proposal A matrix spec change proposal
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants