Skip to content

MSC3267: Reference relations - #3267

Merged
turt2live merged 7 commits into
old_masterfrom
aggregations-references
Jul 17, 2022
Merged

turt2live merged 7 commits into
old_masterfrom
aggregations-references

Conversation

@bwindels

@bwindels bwindels commented Jul 5, 2021

Copy link
Copy Markdown
Contributor

@bwindels bwindels changed the title MSCXXXX: Reference relations MSC 3267: Reference relations Jul 5, 2021
Comment thread proposals/3267-reference-relations.md Outdated
@uhoreg uhoreg added kind:feature MSC for not-core and not-maintenance stuff needs-implementation This MSC does not have a qualifying implementation for the SCT to review. The MSC cannot enter FCP. proposal A matrix spec change proposal. Process state. proposal-in-review labels Jul 5, 2021
@uhoreg

uhoreg commented Jul 5, 2021

Copy link
Copy Markdown
Member

Tagged as needs-implementation even though the verification use-case in implemented, since the non-verification use-case is not yet implemented

@jryans jryans changed the title MSC 3267: Reference relations MSC3267: Reference relations Jul 7, 2021
@turt2live turt2live added A-Client Server Client-Server API and removed proposal-in-review labels Nov 24, 2021
Comment thread proposals/3267-reference-relations.md Outdated
Comment thread proposals/3267-reference-relations.md
@jplatte

jplatte commented May 17, 2022

Copy link
Copy Markdown
Contributor

Given that m.references has already found its way into the spec for encrypted events and threads have gone a different direction if I'm not getting things mixed up, should this MSC be closed?

@turt2live

Copy link
Copy Markdown
Member

(please use threads to receive in-depth/any replies)

The way m.reference has made it into the spec currently doesn't require this MSC, but it looks super strange indeed. We should fast track this to FCP, I guess.

@turt2live

Copy link
Copy Markdown
Member

going to use the key verification framework as an implementation proof for this - https://spec.matrix.org/v1.2/client-server-api/#key-verification-framework

@turt2live turt2live removed the needs-implementation This MSC does not have a qualifying implementation for the SCT to review. The MSC cannot enter FCP. label May 20, 2022
@turt2live

Copy link
Copy Markdown
Member

@bwindels apologies, I've taken this over in an effort to get it through (finally).

@turt2live
turt2live marked this pull request as ready for review May 20, 2022 01:53
Comment on lines +9 to +13
A `rel_type` of `m.reference` is defined as a generic way to associate an
event with another event. As a bundle, `m.reference` relations appear as
an object with a single `chunk` field. The `chunk` is an array of objects
with a single `event_id` field for all the child events which `m.reference`
the parent.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is just the first "page" of results, if there's a next_token, that can be given to /relations to get the rest.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps we can just remove the word "all" in this sentence to eliminate any subtle confusion.

for events to make a reference to another event.

A `rel_type` of `m.reference` is defined as a generic way to associate an
event with another event. As a bundle, `m.reference` relations appear as

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be useful to link to MSC2675 here, which defines bundling related events.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, we can probably just remove the sentences about server-side aggregation given the information is repeated below under the "Server aggregation" header?

Comment on lines +9 to +13
A `rel_type` of `m.reference` is defined as a generic way to associate an
event with another event. As a bundle, `m.reference` relations appear as
an object with a single `chunk` field. The `chunk` is an array of objects
with a single `event_id` field for all the child events which `m.reference`
the parent.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps we can just remove the word "all" in this sentence to eliminate any subtle confusion.


## Server aggregation

[MSC2674](https://github.com/matrix-org/matrix-doc/pull/2674) states

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is MSC2675 now?

@mscbot

mscbot commented Jul 12, 2022

Copy link
Copy Markdown
Collaborator

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

@mscbot mscbot added final-comment-period Process state to accept, reject, or postpone an MSC. and removed proposed-final-comment-period Currently awaiting signoff of a majority of team members in order to enter the FCP. Process state. labels Jul 12, 2022
@mscbot

mscbot commented Jul 17, 2022

Copy link
Copy Markdown
Collaborator

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

@mscbot mscbot added finished-final-comment-period FCP has finished. Process state. and removed disposition-merge Process state. final-comment-period Process state to accept, reject, or postpone an MSC. labels Jul 17, 2022
@turt2live
turt2live merged commit 3f0ba9c into old_master Jul 17, 2022
@turt2live turt2live added spec-pr-missing MSC is accepted, but missing spec PR. Process state. and removed finished-final-comment-period FCP has finished. Process state. labels Jul 17, 2022
turt2live added a commit that referenced this pull request Jul 17, 2022
* initial draft of reference relations msc

* change MSC number

* Apply formatting

* Convert to point at present rather than ideal

* Clarify that multiple relations is a thing we don't have and won't fix here

* Fix wording to match reality, again

* fix a typo

Co-authored-by: Travis Ralston <travisr@matrix.org>
Co-authored-by: Andrew Morgan <andrewm@element.io>
@turt2live turt2live self-assigned this Aug 3, 2022
turt2live added a commit to matrix-org/matrix-spec that referenced this pull request Aug 9, 2022
@turt2live

Copy link
Copy Markdown
Member

Spec PR: matrix-org/matrix-spec#1206

@turt2live turt2live added spec-pr-in-review A proposal which has been PR'd against the spec and is in review and removed spec-pr-missing MSC is accepted, but missing spec PR. Process state. labels Aug 9, 2022
turt2live added a commit to matrix-org/matrix-spec that referenced this pull request Oct 18, 2022
* Spec reference relationships

MSC: matrix-org/matrix-spec-proposals#3267

* Apply suggestions from code review

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

* Edits per code review

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

Copy link
Copy Markdown
Member

Merged 🎉

@turt2live turt2live added merged A proposal whose PR has merged into the spec! Process state. and removed spec-pr-in-review A proposal which has been PR'd against the spec and is in review labels Oct 18, 2022
clokep pushed a commit to clokep/matrix-spec that referenced this pull request May 3, 2023
* Spec reference relationships

MSC: matrix-org/matrix-spec-proposals#3267

* Apply suggestions from code review

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

* Edits per code review

Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Client Server Client-Server API kind:feature MSC for not-core and not-maintenance stuff merged A proposal whose PR has merged into the spec! Process state. proposal A matrix spec change proposal. Process state.

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.