Matrix 1.8 changelog

8 months ago · 529cbf4ffc
parent 7f8606eb6c
commit 529cbf4ffc
43 changed files with 122 additions and 42 deletions
--- a/changelogs/appendices/newsfragments/1573.clarification
+++ b/changelogs/appendices/newsfragments/1573.clarification
@ -1 +0,0 @@
-Clarify spec re canonical JSON to handle negative-zero; also, give an example of negative-zero and a large power of ten.
--- a/changelogs/appendices/newsfragments/1583.feature
+++ b/changelogs/appendices/newsfragments/1583.feature
@ -1 +0,0 @@
-Allow `+` in Matrix IDs, as per [MSC4009](https://github.com/matrix-org/matrix-spec-proposals/pull/4009).
--- a/changelogs/application_service/newsfragments/1584.clarification
+++ b/changelogs/application_service/newsfragments/1584.clarification
@ -1 +0,0 @@
-Fix type of custom `fields` in thirdparty lookup queries.
--- a/changelogs/client_server/newsfragments/1517.feature
+++ b/changelogs/client_server/newsfragments/1517.feature
@ -1 +0,0 @@
-Require callers to be joined to the room to report its events, as per [MSC2249](https://github.com/matrix-org/matrix-spec-proposals/pull/2249).
--- a/changelogs/client_server/newsfragments/1552.clarification
+++ b/changelogs/client_server/newsfragments/1552.clarification
@ -1 +0,0 @@
-Fix missing `type` property in the JSON schema definition of the `m.reaction` event.  Contributed by @chebureki.
--- a/changelogs/client_server/newsfragments/1563.clarification
+++ b/changelogs/client_server/newsfragments/1563.clarification
@ -1 +0,0 @@
-Make sure examples types match schema in definitions.
--- a/changelogs/client_server/newsfragments/1564.clarification
+++ b/changelogs/client_server/newsfragments/1564.clarification
@ -1 +0,0 @@
-Allow `null` in `room_types` in `POST /publicRooms` endpoints schemas.
--- a/changelogs/client_server/newsfragments/1578.clarification
+++ b/changelogs/client_server/newsfragments/1578.clarification
@ -1 +0,0 @@
-Fix broken header formatting. Contributed by @midnightveil.
--- a/changelogs/client_server/newsfragments/1579.clarification
+++ b/changelogs/client_server/newsfragments/1579.clarification
@ -1 +0,0 @@
-Render binary request and response bodies.
--- a/changelogs/client_server/newsfragments/1590.clarification
+++ b/changelogs/client_server/newsfragments/1590.clarification
@ -1 +0,0 @@
-Fix description of MAC calculation in SAS verification.
--- a/changelogs/client_server/newsfragments/1593.clarification
+++ b/changelogs/client_server/newsfragments/1593.clarification
@ -1 +0,0 @@
-Update link to SAS emoji definition data.
--- a/changelogs/client_server/newsfragments/1597.clarification
+++ b/changelogs/client_server/newsfragments/1597.clarification
@ -1 +0,0 @@
-Fix various typos throughout the specification.
--- a/changelogs/identity_service/newsfragments/1563.clarification
+++ b/changelogs/identity_service/newsfragments/1563.clarification
@ -1 +0,0 @@
-Make sure examples types match schema in definitions.
--- a/changelogs/internal/newsfragments/1310.feature
+++ b/changelogs/internal/newsfragments/1310.feature
@ -1 +0,0 @@
-Upgrade Swagger data to OpenAPI 3.1.
--- a/changelogs/internal/newsfragments/1542.clarification
+++ b/changelogs/internal/newsfragments/1542.clarification
@ -1 +0,0 @@
-Update the CI to validate the file extension of changelog entries.
--- a/changelogs/internal/newsfragments/1549.clarification
+++ b/changelogs/internal/newsfragments/1549.clarification
@ -1 +0,0 @@
-Disclosure sections now only display their title when collapsed.
--- a/changelogs/internal/newsfragments/1551.clarification
+++ b/changelogs/internal/newsfragments/1551.clarification
@ -1 +0,0 @@
-Fix the sidebar in recent versions of Hugo.
--- a/changelogs/internal/newsfragments/1556.clarification
+++ b/changelogs/internal/newsfragments/1556.clarification
@ -1 +0,0 @@
-Bump jsonschema to validate JSON Schemas against Draft 2020-12.
--- a/changelogs/internal/newsfragments/1558.clarification
+++ b/changelogs/internal/newsfragments/1558.clarification
@ -1 +0,0 @@
-Use Redocly CLI to validate OpenAPI definitions.
--- a/changelogs/internal/newsfragments/1561.clarification
+++ b/changelogs/internal/newsfragments/1561.clarification
@ -1 +0,0 @@
-Use tag name as the OpenAPI definition version.
--- a/changelogs/internal/newsfragments/1562.clarification
+++ b/changelogs/internal/newsfragments/1562.clarification
@ -1 +0,0 @@
-Make sure version in `x-changedInMatrixVersion` is a string.
--- a/changelogs/internal/newsfragments/1582.clarification
+++ b/changelogs/internal/newsfragments/1582.clarification
@ -1 +0,0 @@
-Clarify usage of ABNF for grammar in the documentation style guide.
--- a/changelogs/internal/newsfragments/1585.clarification
+++ b/changelogs/internal/newsfragments/1585.clarification
@ -1 +0,0 @@
-Remove unnecessary `oneOf`s in JSON schemas.
--- a/changelogs/internal/newsfragments/1591.clarification
+++ b/changelogs/internal/newsfragments/1591.clarification
@ -1 +0,0 @@
-Update the version of Hugo used to render the spec to v0.113.0.
--- a/changelogs/internal/newsfragments/1598.clarification
+++ b/changelogs/internal/newsfragments/1598.clarification
@ -1 +0,0 @@
-Fix rendered changelog with new version of towncrier.
--- a/changelogs/internal/newsfragments/1601.clarification
+++ b/changelogs/internal/newsfragments/1601.clarification
@ -1 +0,0 @@
-Improve the layout of tables on desktop displays. Contributed by Martin Fischer.
--- a/changelogs/internal/newsfragments/1620.feature
+++ b/changelogs/internal/newsfragments/1620.feature
@ -1 +0,0 @@
-Create `@matrix-org/spec` npm package to ship the SAS Emoji data definitions & translations.
--- a/changelogs/room_versions/newsfragments/1604.feature.1
+++ b/changelogs/room_versions/newsfragments/1604.feature.1
@ -1 +0,0 @@
-Add room version 11 as per [MSC3820](https://github.com/matrix-org/matrix-spec-proposals/pull/3820).
--- a/changelogs/room_versions/newsfragments/1604.feature.2
+++ b/changelogs/room_versions/newsfragments/1604.feature.2
@ -1 +0,0 @@
-Move `redacts` from top level to `content` on `m.room.redaction` events in room version 11, as per [MSC2174](https://github.com/matrix-org/matrix-spec-proposals/pull/2174).
--- a/changelogs/room_versions/newsfragments/1604.feature.3
+++ b/changelogs/room_versions/newsfragments/1604.feature.3
@ -1 +0,0 @@
-Remove `creator` from `m.room.creator` events in room version 11, as per [MSC2175](https://github.com/matrix-org/matrix-spec-proposals/pull/2175).
--- a/changelogs/room_versions/newsfragments/1604.feature.4
+++ b/changelogs/room_versions/newsfragments/1604.feature.4
@ -1 +0,0 @@
-Remove remaining usage of `origin` from events in room version 11, as per [MSC3989](https://github.com/matrix-org/matrix-spec-proposals/pull/3989).
--- a/changelogs/room_versions/newsfragments/1604.feature.5
+++ b/changelogs/room_versions/newsfragments/1604.feature.5
@ -1 +0,0 @@
-Update the redaction rules in room version 11, as per [MSC2176](https://github.com/matrix-org/matrix-spec-proposals/pull/2176) and [MSC3821](https://github.com/matrix-org/matrix-spec-proposals/pull/3821).
--- a/changelogs/server_server/newsfragments/1521.clarification
+++ b/changelogs/server_server/newsfragments/1521.clarification
@ -1 +0,0 @@
-Document why `/state_ids` can respond with a 404.
--- a/changelogs/server_server/newsfragments/1559.clarification
+++ b/changelogs/server_server/newsfragments/1559.clarification
@ -1 +0,0 @@
-Fix response definition for `POST /_matrix/federation/v1/user/keys/claim`.
--- a/changelogs/server_server/newsfragments/1560.clarification
+++ b/changelogs/server_server/newsfragments/1560.clarification
@ -1 +0,0 @@
-Fix examples in server keys definition.
--- a/changelogs/server_server/newsfragments/1563.clarification
+++ b/changelogs/server_server/newsfragments/1563.clarification
@ -1 +0,0 @@
-Make sure examples types match schema in definitions.
--- a/changelogs/server_server/newsfragments/1564.clarification
+++ b/changelogs/server_server/newsfragments/1564.clarification
@ -1 +0,0 @@
-Allow `null` in `room_types` in `POST /publicRooms` endpoints schemas.
--- a/changelogs/server_server/newsfragments/1578.clarification
+++ b/changelogs/server_server/newsfragments/1578.clarification
@ -1 +0,0 @@
-Fix broken header formatting. Contributed by @midnightveil.
--- a/changelogs/server_server/newsfragments/1615.clarification
+++ b/changelogs/server_server/newsfragments/1615.clarification
@ -1 +0,0 @@
-Remove spurious mention of a "default port" with respect to SRV record lookup.
--- a/changelogs/server_server/newsfragments/1623.clarification
+++ b/changelogs/server_server/newsfragments/1623.clarification
@ -1 +0,0 @@
-Switch to ordered list for server name resolution steps.
--- a/changelogs/server_server/newsfragments/1624.deprecation
+++ b/changelogs/server_server/newsfragments/1624.deprecation
@ -1 +0,0 @@
-Deprecate `matrix` SRV lookup steps during server discovery, as per [MSC4040](https://github.com/matrix-org/matrix-spec-proposals/pull/4040).
--- a/changelogs/server_server/newsfragments/1624.feature
+++ b/changelogs/server_server/newsfragments/1624.feature
@ -1 +0,0 @@
-Add `matrix-fed` SRV lookup steps to server discovery, as per [MSC4040](https://github.com/matrix-org/matrix-spec-proposals/pull/4040).
--- a/content/changelog/v1.8.md
+++ b/content/changelog/v1.8.md
@ -0,0 +1,122 @@
+---
+date: 2023-08-23T09:23:53-06:00
+---
+<!--
+This is a header file for the generated changelog.
+
+Variables:
+    v1.8  = Replaced by the version number (eg: v1.2)
+    August 23, 2023     = Replaced by the date (eg: April 01, 2021)
+-->
+
+## v1.8
+
+<table class="release-info">
+<tr><th>Git commit</th><td><a href="https://github.com/matrix-org/matrix-spec/tree/v1.8">https://github.com/matrix-org/matrix-spec/tree/v1.8</a></td>
+<tr><th>Release date</th><td>August 23, 2023</td>
+</table>
+
+<!-- Intentionally blank line to ensure headers work in the concatenated changelog -->
+
+### Client-Server API
+
+**Backwards Compatible Changes**
+
+- Require callers to be joined to the room to report its events, as per [MSC2249](https://github.com/matrix-org/matrix-spec-proposals/pull/2249). ([#1517](https://github.com/matrix-org/matrix-spec/issues/1517))
+
+**Spec Clarifications**
+
+- Fix missing `type` property in the JSON schema definition of the `m.reaction` event.  Contributed by @chebureki. ([#1552](https://github.com/matrix-org/matrix-spec/issues/1552))
+- Make sure examples types match schema in definitions. ([#1563](https://github.com/matrix-org/matrix-spec/issues/1563))
+- Allow `null` in `room_types` in `POST /publicRooms` endpoints schemas. ([#1564](https://github.com/matrix-org/matrix-spec/issues/1564))
+- Fix broken header formatting. Contributed by @midnightveil. ([#1578](https://github.com/matrix-org/matrix-spec/issues/1578))
+- Render binary request and response bodies. ([#1579](https://github.com/matrix-org/matrix-spec/issues/1579))
+- Fix description of MAC calculation in SAS verification. ([#1590](https://github.com/matrix-org/matrix-spec/issues/1590))
+- Update link to SAS emoji definition data. ([#1593](https://github.com/matrix-org/matrix-spec/issues/1593))
+- Fix various typos throughout the specification. ([#1597](https://github.com/matrix-org/matrix-spec/issues/1597))
+
+
+### Server-Server API
+
+**Deprecations**
+
+- Deprecate `matrix` SRV lookup steps during server discovery, as per [MSC4040](https://github.com/matrix-org/matrix-spec-proposals/pull/4040). ([#1624](https://github.com/matrix-org/matrix-spec/issues/1624))
+
+**Backwards Compatible Changes**
+
+- Add `matrix-fed` SRV lookup steps to server discovery, as per [MSC4040](https://github.com/matrix-org/matrix-spec-proposals/pull/4040). ([#1624](https://github.com/matrix-org/matrix-spec/issues/1624))
+
+**Spec Clarifications**
+
+- Document why `/state_ids` can respond with a 404. ([#1521](https://github.com/matrix-org/matrix-spec/issues/1521))
+- Fix response definition for `POST /_matrix/federation/v1/user/keys/claim`. ([#1559](https://github.com/matrix-org/matrix-spec/issues/1559))
+- Fix examples in server keys definition. ([#1560](https://github.com/matrix-org/matrix-spec/issues/1560))
+- Make sure examples types match schema in definitions. ([#1563](https://github.com/matrix-org/matrix-spec/issues/1563))
+- Allow `null` in `room_types` in `POST /publicRooms` endpoints schemas. ([#1564](https://github.com/matrix-org/matrix-spec/issues/1564))
+- Fix broken header formatting. Contributed by @midnightveil. ([#1578](https://github.com/matrix-org/matrix-spec/issues/1578))
+- Remove spurious mention of a "default port" with respect to SRV record lookup. ([#1615](https://github.com/matrix-org/matrix-spec/issues/1615))
+- Switch to ordered list for server name resolution steps. ([#1623](https://github.com/matrix-org/matrix-spec/issues/1623))
+
+
+### Application Service API
+
+**Spec Clarifications**
+
+- Fix type of custom `fields` in thirdparty lookup queries. ([#1584](https://github.com/matrix-org/matrix-spec/issues/1584))
+
+
+### Identity Service API
+
+**Spec Clarifications**
+
+- Make sure examples types match schema in definitions. ([#1563](https://github.com/matrix-org/matrix-spec/issues/1563))
+
+
+### Push Gateway API
+
+No significant changes.
+
+
+### Room Versions
+
+**Backwards Compatible Changes**
+
+- Add room version 11 as per [MSC3820](https://github.com/matrix-org/matrix-spec-proposals/pull/3820). ([#1604](https://github.com/matrix-org/matrix-spec/issues/1604))
+- Move `redacts` from top level to `content` on `m.room.redaction` events in room version 11, as per [MSC2174](https://github.com/matrix-org/matrix-spec-proposals/pull/2174). ([#1604](https://github.com/matrix-org/matrix-spec/issues/1604))
+- Remove `creator` from `m.room.creator` events in room version 11, as per [MSC2175](https://github.com/matrix-org/matrix-spec-proposals/pull/2175). ([#1604](https://github.com/matrix-org/matrix-spec/issues/1604))
+- Remove remaining usage of `origin` from events in room version 11, as per [MSC3989](https://github.com/matrix-org/matrix-spec-proposals/pull/3989). ([#1604](https://github.com/matrix-org/matrix-spec/issues/1604))
+- Update the redaction rules in room version 11, as per [MSC2176](https://github.com/matrix-org/matrix-spec-proposals/pull/2176) and [MSC3821](https://github.com/matrix-org/matrix-spec-proposals/pull/3821). ([#1604](https://github.com/matrix-org/matrix-spec/issues/1604))
+
+
+### Appendices
+
+**Backwards Compatible Changes**
+
+- Allow `+` in Matrix IDs, as per [MSC4009](https://github.com/matrix-org/matrix-spec-proposals/pull/4009). ([#1583](https://github.com/matrix-org/matrix-spec/issues/1583))
+
+**Spec Clarifications**
+
+- Clarify spec re canonical JSON to handle negative-zero; also, give an example of negative-zero and a large power of ten. ([#1573](https://github.com/matrix-org/matrix-spec/issues/1573))
+
+
+### Internal Changes/Tooling
+
+**Backwards Compatible Changes**
+
+- Upgrade Swagger data to OpenAPI 3.1. ([#1310](https://github.com/matrix-org/matrix-spec/issues/1310))
+- Create `@matrix-org/spec` npm package to ship the SAS Emoji data definitions & translations. ([#1620](https://github.com/matrix-org/matrix-spec/issues/1620))
+
+**Spec Clarifications**
+
+- Update the CI to validate the file extension of changelog entries. ([#1542](https://github.com/matrix-org/matrix-spec/issues/1542))
+- Disclosure sections now only display their title when collapsed. ([#1549](https://github.com/matrix-org/matrix-spec/issues/1549))
+- Fix the sidebar in recent versions of Hugo. ([#1551](https://github.com/matrix-org/matrix-spec/issues/1551))
+- Bump jsonschema to validate JSON Schemas against Draft 2020-12. ([#1556](https://github.com/matrix-org/matrix-spec/issues/1556))
+- Use Redocly CLI to validate OpenAPI definitions. ([#1558](https://github.com/matrix-org/matrix-spec/issues/1558))
+- Use tag name as the OpenAPI definition version. ([#1561](https://github.com/matrix-org/matrix-spec/issues/1561))
+- Make sure version in `x-changedInMatrixVersion` is a string. ([#1562](https://github.com/matrix-org/matrix-spec/issues/1562))
+- Clarify usage of ABNF for grammar in the documentation style guide. ([#1582](https://github.com/matrix-org/matrix-spec/issues/1582))
+- Remove unnecessary `oneOf`s in JSON schemas. ([#1585](https://github.com/matrix-org/matrix-spec/issues/1585))
+- Update the version of Hugo used to render the spec to v0.113.0. ([#1591](https://github.com/matrix-org/matrix-spec/issues/1591))
+- Fix rendered changelog with new version of towncrier. ([#1598](https://github.com/matrix-org/matrix-spec/issues/1598))
+- Improve the layout of tables on desktop displays. Contributed by Martin Fischer. ([#1601](https://github.com/matrix-org/matrix-spec/issues/1601))
				`@ -1 +0,0 @@`
				`Clarify spec re canonical JSON to handle negative-zero; also, give an example of negative-zero and a large power of ten.`
				`@ -1 +0,0 @@`
				Allow `+` in Matrix IDs, as per [MSC4009](https://github.com/matrix-org/matrix-spec-proposals/pull/4009).
				`@ -1 +0,0 @@`
				Fix type of custom `fields` in thirdparty lookup queries.
				`@ -1 +0,0 @@`
				`Require callers to be joined to the room to report its events, as per [MSC2249](https://github.com/matrix-org/matrix-spec-proposals/pull/2249).`
				`@ -1 +0,0 @@`
				Fix missing `type` property in the JSON schema definition of the `m.reaction` event. Contributed by @chebureki.
				`@ -1 +0,0 @@`
				`Make sure examples types match schema in definitions.`
				`@ -1 +0,0 @@`
				Allow `null` in `room_types` in `POST /publicRooms` endpoints schemas.
				`@ -1 +0,0 @@`
				`Fix broken header formatting. Contributed by @midnightveil.`
				`@ -1 +0,0 @@`
				`Fix description of MAC calculation in SAS verification.`
				`@ -1 +0,0 @@`
				`Fix various typos throughout the specification.`