Skip to content

Threads: The base - #1254

Merged
turt2live merged 6 commits into
mainfrom
travis/spec/threads
Sep 27, 2022
Merged

turt2live merged 6 commits into
mainfrom
travis/spec/threads

Conversation

@turt2live

@turt2live turt2live commented Sep 27, 2022

Copy link
Copy Markdown
Member

Specifies matrix-org/matrix-spec-proposals#3440 (minus filtering requirements due to MSC3856)
Specifies matrix-org/matrix-spec-proposals#3856
Specifies matrix-org/matrix-spec-proposals#3715

This is reviewable commit-by-commit, for each of the MSCs listed above.

The remainder of the threads work (notifications, read receipts) is handled by #1255.

Requires matrix-org/matrix-spec-proposals#3899 for clarifications.

Preview: https://pr1254--matrix-spec-previews.netlify.app

@turt2live turt2live changed the title Threads Threads: The base Sep 27, 2022
@turt2live
turt2live marked this pull request as ready for review September 27, 2022 04:36
@turt2live
turt2live requested a review from a team as a code owner September 27, 2022 04:36
@turt2live turt2live added the release-blocker Blocks the next release from happening label Sep 27, 2022
@turt2live turt2live mentioned this pull request Sep 27, 2022
13 tasks
Comment thread changelogs/client_server/newsfragments/1254.feature Outdated

@erikjohnston erikjohnston left a comment

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.

Words look good. I defer to @clokep about whether this matches reality (though AIUI it does)

@clokep clokep left a comment

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.

Examples look reasonable to me, just a couple of minor points.

Comment thread content/client-server-api/modules/threading.md Outdated
Comment on lines +181 to +182
`latest_event` is the most recent event (topologically to the server) in the thread sent by an
un-[ignored user](#ignoring-users).

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'm not sure it needs to be called out, but the bundled latest_event should be serialized using the same format as the event itself.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

This is done via the spec and examples implicitly: the other weird formats aren't in the spec anymore, as that's a legacy implementation detail in some clients and servers.

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.

Oh, I hadn't realized those were no longer in the spec. Please ignore me then!

@germain-gg germain-gg left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

lgtm


As a worked example, the following represents a thread and how it'd be formed:

```json

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Should we use json5 or jsonc to highlight syntax here and in other code examples?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

json because hugo does a better job than github, annoyingly.

Comment thread content/client-server-api/modules/threading.md Outdated
turt2live and others added 2 commits September 27, 2022 10:23
Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>
Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>
@turt2live
turt2live requested a review from clokep September 27, 2022 16:24
clokep added a commit to clokep/matrix-spec that referenced this pull request May 3, 2023
* Spec MSC3440: Threading (just the base)

Other threading MSCs to follow

* Spec MSC3856: Threads list API

* Spec MSC3715:  Add`dir` to `/relations`

* changelog

* Apply suggestions from code review

Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>

* Update changelogs/client_server/newsfragments/1254.feature

Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>

Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release-blocker Blocks the next release from happening

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

4 participants