v1.4 changelog

2 years ago · 7a591366c1
parent c8a1046e84
commit 7a591366c1
49 changed files with 141 additions and 47 deletions
--- a/changelogs/application_service/newsfragments/1174.clarification
+++ b/changelogs/application_service/newsfragments/1174.clarification
@ -1 +0,0 @@
-Add HTML anchors for object definitions in the formatted specification.
--- a/changelogs/application_service/newsfragments/1200.breaking
+++ b/changelogs/application_service/newsfragments/1200.breaking
@ -1 +0,0 @@
-Replace homeserver authorization approach with an `Authorization` header instead of `access_token` when talking to the application service, as per [MSC2832](https://github.com/matrix-org/matrix-spec-proposals/pull/2832).
--- a/changelogs/client_server/newsfragments/1084.clarification
+++ b/changelogs/client_server/newsfragments/1084.clarification
@ -1 +0,0 @@
-Mention that the `/rooms/{roomId}/invite` endpoint will return a 200 response if the user is already invited to the room.
--- a/changelogs/client_server/newsfragments/1135.clarification
+++ b/changelogs/client_server/newsfragments/1135.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1155.clarification
+++ b/changelogs/client_server/newsfragments/1155.clarification
@ -1 +0,0 @@
-Describe return codes for account data endpoints, and clarify that per-room data does not inherit from the global data.
--- a/changelogs/client_server/newsfragments/1161.clarification
+++ b/changelogs/client_server/newsfragments/1161.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1164.clarification
+++ b/changelogs/client_server/newsfragments/1164.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1165.clarification
+++ b/changelogs/client_server/newsfragments/1165.clarification
@ -1 +0,0 @@
-Clarify that policy rule globs work like ACL globs. Contributed by Nico.
--- a/changelogs/client_server/newsfragments/1166.clarification
+++ b/changelogs/client_server/newsfragments/1166.clarification
@ -1 +0,0 @@
-Clarify the format of some structures in the End-to-end encryption module.
--- a/changelogs/client_server/newsfragments/1170.clarification
+++ b/changelogs/client_server/newsfragments/1170.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1174.clarification
+++ b/changelogs/client_server/newsfragments/1174.clarification
@ -1 +0,0 @@
-Add HTML anchors for object definitions in the formatted specification.
--- a/changelogs/client_server/newsfragments/1179.clarification
+++ b/changelogs/client_server/newsfragments/1179.clarification
@ -1 +0,0 @@
-Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions.
--- a/changelogs/client_server/newsfragments/1180.clarification
+++ b/changelogs/client_server/newsfragments/1180.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1185.clarification
+++ b/changelogs/client_server/newsfragments/1185.clarification
@ -1 +0,0 @@
-Update "API Standards" section to clarify how JSON is used.
--- a/changelogs/client_server/newsfragments/1190.feature
+++ b/changelogs/client_server/newsfragments/1190.feature
@ -1 +0,0 @@
-Add a `.m.rule.room.server_acl` push rule to match `m.room.server_acl` events, as per [MSC3786](https://github.com/matrix-org/matrix-spec-proposals/pull/3786).
--- a/changelogs/client_server/newsfragments/1196.removal
+++ b/changelogs/client_server/newsfragments/1196.removal
@ -1 +0,0 @@
-Remove unused policy room sharing mechanism, as per [MSC3844](https://github.com/matrix-org/matrix-spec-proposals/pull/3844).
--- a/changelogs/client_server/newsfragments/1197.feature
+++ b/changelogs/client_server/newsfragments/1197.feature
@ -1 +0,0 @@
-Add `Cross-Origin-Resource-Policy` (CORP) headers to media repository, as per [MSC3828](https://github.com/matrix-org/matrix-spec-proposals/pull/3828).
--- a/changelogs/client_server/newsfragments/1198.feature
+++ b/changelogs/client_server/newsfragments/1198.feature
@ -1 +0,0 @@
-Copy a room's `type` when upgrading it, as per [MSC3818](https://github.com/matrix-org/matrix-spec-proposals/pull/3818).
--- a/changelogs/client_server/newsfragments/1199.feature
+++ b/changelogs/client_server/newsfragments/1199.feature
@ -1 +0,0 @@
-Add `room_types` filter and `room_type` response to `/publicRooms`, as per [MSC3827](https://github.com/matrix-org/matrix-spec-proposals/pull/3827).
--- a/changelogs/client_server/newsfragments/1201.feature
+++ b/changelogs/client_server/newsfragments/1201.feature
@ -1 +0,0 @@
-Add a `.m.rule.room.server_acl` push rule to match `m.room.server_acl` events, as per [MSC3786](https://github.com/matrix-org/matrix-spec-proposals/pull/3786).
--- a/changelogs/client_server/newsfragments/1210.clarification
+++ b/changelogs/client_server/newsfragments/1210.clarification
@ -1 +0,0 @@
-Clarify that the "device_id", "user_id" and "access_token" fields are required in the response body of `POST /_matrix/client/v3/login`.
--- a/changelogs/client_server/newsfragments/1211.feature
+++ b/changelogs/client_server/newsfragments/1211.feature
@ -1 +0,0 @@
-Add `m.replace` relations (event edits), as per [MSC2676](https://github.com/matrix-org/matrix-spec-proposals/pull/2676).
--- a/changelogs/client_server/newsfragments/1215.clarification
+++ b/changelogs/client_server/newsfragments/1215.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1216.feature.1
+++ b/changelogs/client_server/newsfragments/1216.feature.1
@ -1 +0,0 @@
-Add `m.read.private` receipts, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285).
--- a/changelogs/client_server/newsfragments/1216.feature.2
+++ b/changelogs/client_server/newsfragments/1216.feature.2
@ -1 +0,0 @@
-Make `m.fully_read` optional on `/read_markers`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285).
--- a/changelogs/client_server/newsfragments/1216.feature.3
+++ b/changelogs/client_server/newsfragments/1216.feature.3
@ -1 +0,0 @@
-Allow `m.fully_read` markers to be set from `/receipts`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285).
--- a/changelogs/client_server/newsfragments/1236.clarification
+++ b/changelogs/client_server/newsfragments/1236.clarification
@ -1 +0,0 @@
-Reinforce the relationship of refreshed access tokens to transaction IDs.
--- a/changelogs/client_server/newsfragments/1238.clarification
+++ b/changelogs/client_server/newsfragments/1238.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1240.clarification
+++ b/changelogs/client_server/newsfragments/1240.clarification
@ -1 +0,0 @@
-Clarify enum values by separating possible values with commas.
--- a/changelogs/client_server/newsfragments/1243.clarification
+++ b/changelogs/client_server/newsfragments/1243.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/1254.feature
+++ b/changelogs/client_server/newsfragments/1254.feature
@ -1 +0,0 @@
-Add threading via `m.thread` relations, as per [MSC3440](https://github.com/matrix-org/matrix-spec-proposals/pull/3440), [MSC3816](https://github.com/matrix-org/matrix-spec-proposals/pull/3816), [MSC3856](https://github.com/matrix-org/matrix-spec-proposals/pull/3856), and [MSC3715](https://github.com/matrix-org/matrix-spec-proposals/pull/3715).
--- a/changelogs/client_server/newsfragments/1255.feature
+++ b/changelogs/client_server/newsfragments/1255.feature
@ -1 +0,0 @@
-Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773).
--- a/changelogs/identity_service/newsfragments/1174.clarification
+++ b/changelogs/identity_service/newsfragments/1174.clarification
@ -1 +0,0 @@
-Add HTML anchors for object definitions in the formatted specification.
--- a/changelogs/identity_service/newsfragments/1185.clarification
+++ b/changelogs/identity_service/newsfragments/1185.clarification
@ -1 +0,0 @@
-Update "API Standards" section to clarify how JSON is used.
--- a/changelogs/internal/newsfragments/1191.clarification
+++ b/changelogs/internal/newsfragments/1191.clarification
@ -1 +0,0 @@
-Render HTML anchors for object definition tables.
--- a/changelogs/internal/newsfragments/1194.feature
+++ b/changelogs/internal/newsfragments/1194.feature
@ -1 +0,0 @@
-Add internal changes changelog section.
--- a/changelogs/internal/newsfragments/1195.clarification
+++ b/changelogs/internal/newsfragments/1195.clarification
@ -1 +0,0 @@
-Give rendered-data sections a background and some padding.
--- a/changelogs/internal/newsfragments/1205.clarification
+++ b/changelogs/internal/newsfragments/1205.clarification
@ -1 +0,0 @@
-Fix rendering of shortcodes within the client-server API.
--- a/changelogs/internal/newsfragments/1230.clarification
+++ b/changelogs/internal/newsfragments/1230.clarification
@ -1 +0,0 @@
-Fix the spacing of mapping types generated from the OpenAPI spec.
--- a/changelogs/push_gateway/newsfragments/1174.clarification
+++ b/changelogs/push_gateway/newsfragments/1174.clarification
@ -1 +0,0 @@
-Add HTML anchors for object definitions in the formatted specification.
--- a/changelogs/room_versions/newsfragments/1137.clarification
+++ b/changelogs/room_versions/newsfragments/1137.clarification
@ -1 +0,0 @@
-For room versions 1 through 10, clarify that events with rejected `auth_events` must be rejected.
--- a/changelogs/room_versions/newsfragments/1158.clarification
+++ b/changelogs/room_versions/newsfragments/1158.clarification
@ -1 +0,0 @@
-For room versions 2–10: correct a mistaken clarification to the state resolution algorithm.
--- a/changelogs/room_versions/newsfragments/1175.clarification
+++ b/changelogs/room_versions/newsfragments/1175.clarification
@ -1 +0,0 @@
-For room versions 7 through 10: Clarify that `invite->knock` is actually a legal transition.
--- a/changelogs/server_server/newsfragments/1174.clarification
+++ b/changelogs/server_server/newsfragments/1174.clarification
@ -1 +0,0 @@
-Add HTML anchors for object definitions in the formatted specification.
--- a/changelogs/server_server/newsfragments/1179.clarification
+++ b/changelogs/server_server/newsfragments/1179.clarification
@ -1 +0,0 @@
-Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions.
--- a/changelogs/server_server/newsfragments/1185.clarification
+++ b/changelogs/server_server/newsfragments/1185.clarification
@ -1 +0,0 @@
-Update "API Standards" section to clarify how JSON is used.
--- a/changelogs/server_server/newsfragments/1255.feature
+++ b/changelogs/server_server/newsfragments/1255.feature
@ -1 +0,0 @@
-Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773).
--- a/content/changelog.md
+++ b/content/changelog.md
@ -9,6 +9,7 @@ weight: 1000
 {{% changelog/changelog-changes %}}

 <!-- DO NOT REMOVE OR CHANGE - Release script puts next release here -->
+{{% changelog/changelog-rendered p="changelogs/v1.4.md" %}}
 {{% changelog/changelog-rendered p="changelogs/v1.3.md" %}}
 {{% changelog/changelog-rendered p="changelogs/v1.2.md" %}}
 {{% changelog/changelog-rendered p="changelogs/v1.1.md" %}}
--- a/layouts/partials/changelogs/v1.4.md
+++ b/layouts/partials/changelogs/v1.4.md
@ -0,0 +1,140 @@
+<!--
+This is a header file for the generated changelog.
+
+Variables:
+    v1.4  = Replaced by the version number (eg: v1.2)
+    September 29, 2022     = Replaced by the date (eg: April 01, 2021)
+-->
+
+## v1.4
+
+<table class="release-info">
+<tr><th>Git commit</th><td><a href="https://github.com/matrix-org/matrix-spec/tree/v1.4">https://github.com/matrix-org/matrix-spec/tree/v1.4</a></td>
+<tr><th>Release date</th><td>September 29, 2022</td>
+</table>
+
+<!-- Intentionally blank line to ensure headers work in the concatenated changelog -->
+### Client-Server API
+
+
+<strong>Removed Endpoints</strong>
+
+
+- Remove unused policy room sharing mechanism, as per [MSC3844](https://github.com/matrix-org/matrix-spec-proposals/pull/3844). ([#1196](https://github.com/matrix-org/matrix-spec/issues/1196))
+
+
+<strong>Backwards Compatible Changes</strong>
+
+
+- Add a `.m.rule.room.server_acl` push rule to match `m.room.server_acl` events, as per [MSC3786](https://github.com/matrix-org/matrix-spec-proposals/pull/3786). ([#1190](https://github.com/matrix-org/matrix-spec/issues/1190), [#1201](https://github.com/matrix-org/matrix-spec/issues/1201))
+- Add `Cross-Origin-Resource-Policy` (CORP) headers to media repository, as per [MSC3828](https://github.com/matrix-org/matrix-spec-proposals/pull/3828). ([#1197](https://github.com/matrix-org/matrix-spec/issues/1197))
+- Copy a room's `type` when upgrading it, as per [MSC3818](https://github.com/matrix-org/matrix-spec-proposals/pull/3818). ([#1198](https://github.com/matrix-org/matrix-spec/issues/1198))
+- Add `room_types` filter and `room_type` response to `/publicRooms`, as per [MSC3827](https://github.com/matrix-org/matrix-spec-proposals/pull/3827). ([#1199](https://github.com/matrix-org/matrix-spec/issues/1199))
+- Add `m.replace` relations (event edits), as per [MSC2676](https://github.com/matrix-org/matrix-spec-proposals/pull/2676). ([#1211](https://github.com/matrix-org/matrix-spec/issues/1211))
+- Add `m.read.private` receipts, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
+- Make `m.fully_read` optional on `/read_markers`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
+- Allow `m.fully_read` markers to be set from `/receipts`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
+- Add threading via `m.thread` relations, as per [MSC3440](https://github.com/matrix-org/matrix-spec-proposals/pull/3440), [MSC3816](https://github.com/matrix-org/matrix-spec-proposals/pull/3816), [MSC3856](https://github.com/matrix-org/matrix-spec-proposals/pull/3856), and [MSC3715](https://github.com/matrix-org/matrix-spec-proposals/pull/3715). ([#1254](https://github.com/matrix-org/matrix-spec/issues/1254))
+- Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773). ([#1255](https://github.com/matrix-org/matrix-spec/issues/1255))
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Mention that the `/rooms/{roomId}/invite` endpoint will return a 200 response if the user is already invited to the room. ([#1084](https://github.com/matrix-org/matrix-spec/issues/1084))
+- Fix various typos throughout the specification. ([#1135](https://github.com/matrix-org/matrix-spec/issues/1135), [#1161](https://github.com/matrix-org/matrix-spec/issues/1161), [#1164](https://github.com/matrix-org/matrix-spec/issues/1164), [#1170](https://github.com/matrix-org/matrix-spec/issues/1170), [#1180](https://github.com/matrix-org/matrix-spec/issues/1180), [#1215](https://github.com/matrix-org/matrix-spec/issues/1215), [#1238](https://github.com/matrix-org/matrix-spec/issues/1238), [#1243](https://github.com/matrix-org/matrix-spec/issues/1243))
+- Describe return codes for account data endpoints, and clarify that per-room data does not inherit from the global data. ([#1155](https://github.com/matrix-org/matrix-spec/issues/1155))
+- Clarify that policy rule globs work like ACL globs. Contributed by Nico. ([#1165](https://github.com/matrix-org/matrix-spec/issues/1165))
+- Clarify the format of some structures in the End-to-end encryption module. ([#1166](https://github.com/matrix-org/matrix-spec/issues/1166))
+- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
+- Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions. ([#1179](https://github.com/matrix-org/matrix-spec/issues/1179))
+- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
+- Clarify that the "device_id", "user_id" and "access_token" fields are required in the response body of `POST /_matrix/client/v3/login`. ([#1210](https://github.com/matrix-org/matrix-spec/issues/1210))
+- Reinforce the relationship of refreshed access tokens to transaction IDs. ([#1236](https://github.com/matrix-org/matrix-spec/issues/1236))
+- Clarify enum values by separating possible values with commas. ([#1240](https://github.com/matrix-org/matrix-spec/issues/1240))
+
+
+### Server-Server API
+
+
+<strong>Backwards Compatible Changes</strong>
+
+
+- Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773). ([#1255](https://github.com/matrix-org/matrix-spec/issues/1255))
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
+- Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions. ([#1179](https://github.com/matrix-org/matrix-spec/issues/1179))
+- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
+
+
+### Application Service API
+
+
+<strong>Breaking Changes</strong>
+
+
+- Replace homeserver authorization approach with an `Authorization` header instead of `access_token` when talking to the application service, as per [MSC2832](https://github.com/matrix-org/matrix-spec-proposals/pull/2832). ([#1200](https://github.com/matrix-org/matrix-spec/issues/1200))
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
+
+
+### Identity Service API
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
+- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
+
+
+### Push Gateway API
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
+
+
+### Room Versions
+
+
+<strong>Spec Clarifications</strong>
+
+
+- For room versions 1 through 10, clarify that events with rejected `auth_events` must be rejected. ([#1137](https://github.com/matrix-org/matrix-spec/issues/1137))
+- For room versions 2–10: correct a mistaken clarification to the state resolution algorithm. ([#1158](https://github.com/matrix-org/matrix-spec/issues/1158))
+- For room versions 7 through 10: Clarify that `invite->knock` is actually a legal transition. ([#1175](https://github.com/matrix-org/matrix-spec/issues/1175))
+
+
+### Appendices
+
+
+No significant changes.
+
+
+### Internal Changes/Tooling
+
+
+<strong>Backwards Compatible Changes</strong>
+
+
+- Add internal changes changelog section. ([#1194](https://github.com/matrix-org/matrix-spec/issues/1194))
+
+
+<strong>Spec Clarifications</strong>
+
+
+- Render HTML anchors for object definition tables. ([#1191](https://github.com/matrix-org/matrix-spec/issues/1191))
+- Give rendered-data sections a background and some padding. ([#1195](https://github.com/matrix-org/matrix-spec/issues/1195))
+- Fix rendering of shortcodes within the client-server API. ([#1205](https://github.com/matrix-org/matrix-spec/issues/1205))
+- Fix the spacing of mapping types generated from the OpenAPI spec. ([#1230](https://github.com/matrix-org/matrix-spec/issues/1230))
				`@ -1 +0,0 @@`
				`Add HTML anchors for object definitions in the formatted specification.`
				`@ -1 +0,0 @@`
				Replace homeserver authorization approach with an `Authorization` header instead of `access_token` when talking to the application service, as per [MSC2832](https://github.com/matrix-org/matrix-spec-proposals/pull/2832).
				`@ -1 +0,0 @@`
				Mention that the `/rooms/{roomId}/invite` endpoint will return a 200 response if the user is already invited to the room.
				`@ -1 +0,0 @@`
				`Fix various typos throughout the specification.`
				`@ -1 +0,0 @@`
				`Describe return codes for account data endpoints, and clarify that per-room data does not inherit from the global data.`
				`@ -1 +0,0 @@`
				`Clarify that policy rule globs work like ACL globs. Contributed by Nico.`
				`@ -1 +0,0 @@`
				`Clarify the format of some structures in the End-to-end encryption module.`
				`@ -1 +0,0 @@`
				Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions.
				`@ -1 +0,0 @@`
				`Update "API Standards" section to clarify how JSON is used.`
				`@ -1 +0,0 @@`
				Add a `.m.rule.room.server_acl` push rule to match `m.room.server_acl` events, as per [MSC3786](https://github.com/matrix-org/matrix-spec-proposals/pull/3786).