From fe880fdaf4f7f8c4f95fe56ea5a0a1ce9498f270 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Thu, 27 Mar 2025 10:28:55 -0600 Subject: [PATCH] v1.14 --- .../newsfragments/1506.clarification | 1 - .../newsfragments/2036.clarification | 1 - .../newsfragments/2038.clarification | 1 - .../newsfragments/2046.clarification | 1 - .../newsfragments/2047.clarification | 1 - .../newsfragments/2048.clarification | 1 - .../newsfragments/2051.clarification | 1 - .../newsfragments/2055.clarification | 1 - .../client_server/newsfragments/2059.removal | 1 - .../newsfragments/2064.clarification | 1 - .../newsfragments/2072.clarification | 1 - .../newsfragments/2080.clarification | 1 - .../newsfragments/2091.clarification | 1 - .../client_server/newsfragments/2093.new | 1 - .../internal/newsfragments/2033.clarification | 1 - .../internal/newsfragments/2041.clarification | 1 - .../internal/newsfragments/2042.clarification | 1 - .../internal/newsfragments/2045.clarification | 1 - .../internal/newsfragments/2049.clarification | 1 - .../internal/newsfragments/2061.clarification | 1 - .../internal/newsfragments/2069.clarification | 1 - .../internal/newsfragments/2073.clarification | 1 - .../internal/newsfragments/2074.clarification | 1 - .../internal/newsfragments/2076.clarification | 1 - .../internal/newsfragments/2078.clarification | 1 - .../newsfragments/2065.clarification | 1 - .../newsfragments/2066.clarification | 1 - .../newsfragments/2070.clarification | 1 - .../room_versions/newsfragments/2105.feature | 1 - .../newsfragments/2114.clarification | 1 - .../newsfragments/2050.clarification | 1 - .../newsfragments/2063.clarification | 1 - .../newsfragments/2076.clarification | 1 - config/_default/hugo.toml | 6 +- content/changelog/v1.14.md | 93 +++++++++++++++++++ 35 files changed, 96 insertions(+), 36 deletions(-) delete mode 100644 changelogs/appendices/newsfragments/1506.clarification delete mode 100644 changelogs/client_server/newsfragments/2036.clarification delete mode 100644 changelogs/client_server/newsfragments/2038.clarification delete mode 100644 changelogs/client_server/newsfragments/2046.clarification delete mode 100644 changelogs/client_server/newsfragments/2047.clarification delete mode 100644 changelogs/client_server/newsfragments/2048.clarification delete mode 100644 changelogs/client_server/newsfragments/2051.clarification delete mode 100644 changelogs/client_server/newsfragments/2055.clarification delete mode 100644 changelogs/client_server/newsfragments/2059.removal delete mode 100644 changelogs/client_server/newsfragments/2064.clarification delete mode 100644 changelogs/client_server/newsfragments/2072.clarification delete mode 100644 changelogs/client_server/newsfragments/2080.clarification delete mode 100644 changelogs/client_server/newsfragments/2091.clarification delete mode 100644 changelogs/client_server/newsfragments/2093.new delete mode 100644 changelogs/internal/newsfragments/2033.clarification delete mode 100644 changelogs/internal/newsfragments/2041.clarification delete mode 100644 changelogs/internal/newsfragments/2042.clarification delete mode 100644 changelogs/internal/newsfragments/2045.clarification delete mode 100644 changelogs/internal/newsfragments/2049.clarification delete mode 100644 changelogs/internal/newsfragments/2061.clarification delete mode 100644 changelogs/internal/newsfragments/2069.clarification delete mode 100644 changelogs/internal/newsfragments/2073.clarification delete mode 100644 changelogs/internal/newsfragments/2074.clarification delete mode 100644 changelogs/internal/newsfragments/2076.clarification delete mode 100644 changelogs/internal/newsfragments/2078.clarification delete mode 100644 changelogs/room_versions/newsfragments/2065.clarification delete mode 100644 changelogs/room_versions/newsfragments/2066.clarification delete mode 100644 changelogs/room_versions/newsfragments/2070.clarification delete mode 100644 changelogs/room_versions/newsfragments/2105.feature delete mode 100644 changelogs/room_versions/newsfragments/2114.clarification delete mode 100644 changelogs/server_server/newsfragments/2050.clarification delete mode 100644 changelogs/server_server/newsfragments/2063.clarification delete mode 100644 changelogs/server_server/newsfragments/2076.clarification create mode 100644 content/changelog/v1.14.md diff --git a/changelogs/appendices/newsfragments/1506.clarification b/changelogs/appendices/newsfragments/1506.clarification deleted file mode 100644 index 41ef5ac4..00000000 --- a/changelogs/appendices/newsfragments/1506.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that arbitrary unicode is allowed in user/room IDs and room aliases. diff --git a/changelogs/client_server/newsfragments/2036.clarification b/changelogs/client_server/newsfragments/2036.clarification deleted file mode 100644 index 9e586ae0..00000000 --- a/changelogs/client_server/newsfragments/2036.clarification +++ /dev/null @@ -1 +0,0 @@ -The `POST /_matrix/client/v3/rooms/{roomId}/initialSync` endpoint is no longer deprecated, as it is still used for peeking. diff --git a/changelogs/client_server/newsfragments/2038.clarification b/changelogs/client_server/newsfragments/2038.clarification deleted file mode 100644 index 169ca65c..00000000 --- a/changelogs/client_server/newsfragments/2038.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify wording in the `/join` endpoints' summaries and descriptions. Contributed by @HarHarLinks. diff --git a/changelogs/client_server/newsfragments/2046.clarification b/changelogs/client_server/newsfragments/2046.clarification deleted file mode 100644 index bdcce777..00000000 --- a/changelogs/client_server/newsfragments/2046.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify formats of string types. diff --git a/changelogs/client_server/newsfragments/2047.clarification b/changelogs/client_server/newsfragments/2047.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/2047.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/2048.clarification b/changelogs/client_server/newsfragments/2048.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/2048.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/2051.clarification b/changelogs/client_server/newsfragments/2051.clarification deleted file mode 100644 index 30cdbc73..00000000 --- a/changelogs/client_server/newsfragments/2051.clarification +++ /dev/null @@ -1 +0,0 @@ -Document the `instance_id` field of `Protocol Instance` in the responses to `GET /_matrix/client/v3/thirdparty/protocols` and `GET /_matrix/client/v3/thirdparty/protocol/{protocol}`. diff --git a/changelogs/client_server/newsfragments/2055.clarification b/changelogs/client_server/newsfragments/2055.clarification deleted file mode 100644 index f8d79ec9..00000000 --- a/changelogs/client_server/newsfragments/2055.clarification +++ /dev/null @@ -1 +0,0 @@ -Applying redactions is a SHOULD for clients. diff --git a/changelogs/client_server/newsfragments/2059.removal b/changelogs/client_server/newsfragments/2059.removal deleted file mode 100644 index 1075c2e0..00000000 --- a/changelogs/client_server/newsfragments/2059.removal +++ /dev/null @@ -1 +0,0 @@ -Remove `server_name` parameter from `/_matrix/client/v3/join/{roomIdOrAlias}` and `/_matrix/client/v3/knock/{roomIdOrAlias}`, as per [MSC4213](https://github.com/matrix-org/matrix-spec-proposals/pull/4213). diff --git a/changelogs/client_server/newsfragments/2064.clarification b/changelogs/client_server/newsfragments/2064.clarification deleted file mode 100644 index 17cc2890..00000000 --- a/changelogs/client_server/newsfragments/2064.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify which rooms are returned from `/hierarchy`. diff --git a/changelogs/client_server/newsfragments/2072.clarification b/changelogs/client_server/newsfragments/2072.clarification deleted file mode 100644 index ddb9a536..00000000 --- a/changelogs/client_server/newsfragments/2072.clarification +++ /dev/null @@ -1 +0,0 @@ -Clients can choose which history visibility options they offer to users when creating rooms. diff --git a/changelogs/client_server/newsfragments/2080.clarification b/changelogs/client_server/newsfragments/2080.clarification deleted file mode 100644 index ca5f3aea..00000000 --- a/changelogs/client_server/newsfragments/2080.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/2091.clarification b/changelogs/client_server/newsfragments/2091.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/2091.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/2093.new b/changelogs/client_server/newsfragments/2093.new deleted file mode 100644 index 931b93ae..00000000 --- a/changelogs/client_server/newsfragments/2093.new +++ /dev/null @@ -1 +0,0 @@ -Add `POST /_matrix/client/v3/users/{userId}/report`, as per [MSC4260](https://github.com/matrix-org/matrix-spec-proposals/pull/4260). \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2033.clarification b/changelogs/internal/newsfragments/2033.clarification deleted file mode 100644 index 9d3e7596..00000000 --- a/changelogs/internal/newsfragments/2033.clarification +++ /dev/null @@ -1 +0,0 @@ -Generate the changelog release info with Hugo, rather than the changelog generation script. diff --git a/changelogs/internal/newsfragments/2041.clarification b/changelogs/internal/newsfragments/2041.clarification deleted file mode 100644 index fd9a66f7..00000000 --- a/changelogs/internal/newsfragments/2041.clarification +++ /dev/null @@ -1 +0,0 @@ -Update release steps documentation. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2042.clarification b/changelogs/internal/newsfragments/2042.clarification deleted file mode 100644 index 4abe8e4e..00000000 --- a/changelogs/internal/newsfragments/2042.clarification +++ /dev/null @@ -1 +0,0 @@ -Remove unused `release_date` from Hugo config. diff --git a/changelogs/internal/newsfragments/2045.clarification b/changelogs/internal/newsfragments/2045.clarification deleted file mode 100644 index bfe42c51..00000000 --- a/changelogs/internal/newsfragments/2045.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that v1.0 of Matrix was a release prior to the current global versioning system. diff --git a/changelogs/internal/newsfragments/2049.clarification b/changelogs/internal/newsfragments/2049.clarification deleted file mode 100644 index 5a6e90f1..00000000 --- a/changelogs/internal/newsfragments/2049.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix syntax highlighting and click-to-copy buttons for code blocks by purging less CSS. diff --git a/changelogs/internal/newsfragments/2061.clarification b/changelogs/internal/newsfragments/2061.clarification deleted file mode 100644 index 3257cef1..00000000 --- a/changelogs/internal/newsfragments/2061.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix the version of the Identity Service API when Matrix 1.0 was introduced. diff --git a/changelogs/internal/newsfragments/2069.clarification b/changelogs/internal/newsfragments/2069.clarification deleted file mode 100644 index 2ad407fb..00000000 --- a/changelogs/internal/newsfragments/2069.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix parsing of nested slices in `resolve-refs` and `resolve-allof` partials. diff --git a/changelogs/internal/newsfragments/2073.clarification b/changelogs/internal/newsfragments/2073.clarification deleted file mode 100644 index 64dbc6c4..00000000 --- a/changelogs/internal/newsfragments/2073.clarification +++ /dev/null @@ -1 +0,0 @@ -Deduplicate the definition of `RoomKeysUpdateResponse`. diff --git a/changelogs/internal/newsfragments/2074.clarification b/changelogs/internal/newsfragments/2074.clarification deleted file mode 100644 index 4f941dd2..00000000 --- a/changelogs/internal/newsfragments/2074.clarification +++ /dev/null @@ -1 +0,0 @@ -Deduplicate the definitions of `Invite3pid`. diff --git a/changelogs/internal/newsfragments/2076.clarification b/changelogs/internal/newsfragments/2076.clarification deleted file mode 100644 index 3cf1fb94..00000000 --- a/changelogs/internal/newsfragments/2076.clarification +++ /dev/null @@ -1 +0,0 @@ -Support more locations for examples in OpenAPI definitions and JSON schemas. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2078.clarification b/changelogs/internal/newsfragments/2078.clarification deleted file mode 100644 index d9285d5a..00000000 --- a/changelogs/internal/newsfragments/2078.clarification +++ /dev/null @@ -1 +0,0 @@ -Add link to the git commit for the unstable changelog. diff --git a/changelogs/room_versions/newsfragments/2065.clarification b/changelogs/room_versions/newsfragments/2065.clarification deleted file mode 100644 index e7fc9f20..00000000 --- a/changelogs/room_versions/newsfragments/2065.clarification +++ /dev/null @@ -1 +0,0 @@ -For room versions 6 and 7, clarify in the authorization rules that `m.federate` must be checked and that events with rejected auth events must be rejected, for parity with all the other room versions. diff --git a/changelogs/room_versions/newsfragments/2066.clarification b/changelogs/room_versions/newsfragments/2066.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/room_versions/newsfragments/2066.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/room_versions/newsfragments/2070.clarification b/changelogs/room_versions/newsfragments/2070.clarification deleted file mode 100644 index 7d0208cd..00000000 --- a/changelogs/room_versions/newsfragments/2070.clarification +++ /dev/null @@ -1 +0,0 @@ -Refactor PDU definitions to reduce duplication. diff --git a/changelogs/room_versions/newsfragments/2105.feature b/changelogs/room_versions/newsfragments/2105.feature deleted file mode 100644 index 9e13a36c..00000000 --- a/changelogs/room_versions/newsfragments/2105.feature +++ /dev/null @@ -1 +0,0 @@ -Update the default room version to 11, as per [MSC4239](https://github.com/matrix-org/matrix-spec-proposals/pull/4239). diff --git a/changelogs/room_versions/newsfragments/2114.clarification b/changelogs/room_versions/newsfragments/2114.clarification deleted file mode 100644 index 46104473..00000000 --- a/changelogs/room_versions/newsfragments/2114.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify the maximum `depth` value for room versions 6, 7, 8, 9, 10, and 11. \ No newline at end of file diff --git a/changelogs/server_server/newsfragments/2050.clarification b/changelogs/server_server/newsfragments/2050.clarification deleted file mode 100644 index 8c4545d3..00000000 --- a/changelogs/server_server/newsfragments/2050.clarification +++ /dev/null @@ -1 +0,0 @@ -Remove the `origin` field in `PUT /send_join` responses, because it was never sent in the first place. diff --git a/changelogs/server_server/newsfragments/2063.clarification b/changelogs/server_server/newsfragments/2063.clarification deleted file mode 100644 index 4e3df516..00000000 --- a/changelogs/server_server/newsfragments/2063.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that `m.join_rules` should be in the `auth_events` of an `m.room.member` event with a `membership` of `knock`. \ No newline at end of file diff --git a/changelogs/server_server/newsfragments/2076.clarification b/changelogs/server_server/newsfragments/2076.clarification deleted file mode 100644 index b3cad0d2..00000000 --- a/changelogs/server_server/newsfragments/2076.clarification +++ /dev/null @@ -1 +0,0 @@ -Remove an erroneous `room_id` field in a few examples. diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml index 84362b3b..3ad53623 100644 --- a/config/_default/hugo.toml +++ b/config/_default/hugo.toml @@ -61,13 +61,13 @@ copyright = "The Matrix.org Foundation CIC" [params.version] # must be one of "unstable", "current", "historical" # this is used to decide whether to show a banner pointing to the current release -status = "unstable" +status = "stable" # A URL pointing to the latest, stable release of the spec. To be shown in the unstable version warning banner. current_version_url = "https://spec.matrix.org/latest" # The following is used when status = "stable", and is displayed in various UI elements on a released version # of the spec. -# major = "1" -# minor = "13" +major = "1" +minor = "14" # User interface configuration [params.ui] diff --git a/content/changelog/v1.14.md b/content/changelog/v1.14.md new file mode 100644 index 00000000..d5f14aba --- /dev/null +++ b/content/changelog/v1.14.md @@ -0,0 +1,93 @@ +--- +title: v1.14 Changelog +linkTitle: v1.14 +type: docs +layout: changelog +outputs: + - html + - checklist +date: 2025-03-27 +--- + +## Client-Server API + +**New Endpoints** + +- Add `POST /_matrix/client/v3/users/{userId}/report`, as per [MSC4260](https://github.com/matrix-org/matrix-spec-proposals/pull/4260). ([#2093](https://github.com/matrix-org/matrix-spec/issues/2093)) + +**Removed Endpoints** + +- Remove `server_name` parameter from `/_matrix/client/v3/join/{roomIdOrAlias}` and `/_matrix/client/v3/knock/{roomIdOrAlias}`, as per [MSC4213](https://github.com/matrix-org/matrix-spec-proposals/pull/4213). ([#2059](https://github.com/matrix-org/matrix-spec/issues/2059)) + +**Spec Clarifications** + +- The `POST /_matrix/client/v3/rooms/{roomId}/initialSync` endpoint is no longer deprecated, as it is still used for peeking. ([#2036](https://github.com/matrix-org/matrix-spec/issues/2036)) +- Clarify wording in the `/join` endpoints' summaries and descriptions. Contributed by @HarHarLinks. ([#2038](https://github.com/matrix-org/matrix-spec/issues/2038)) +- Clarify formats of string types. ([#2046](https://github.com/matrix-org/matrix-spec/issues/2046)) +- Fix various typos throughout the specification. ([#2047](https://github.com/matrix-org/matrix-spec/issues/2047), [#2048](https://github.com/matrix-org/matrix-spec/issues/2048), [#2080](https://github.com/matrix-org/matrix-spec/issues/2080), [#2091](https://github.com/matrix-org/matrix-spec/issues/2091)) +- Document the `instance_id` field of `Protocol Instance` in the responses to `GET /_matrix/client/v3/thirdparty/protocols` and `GET /_matrix/client/v3/thirdparty/protocol/{protocol}`. ([#2051](https://github.com/matrix-org/matrix-spec/issues/2051)) +- Applying redactions is a SHOULD for clients. ([#2055](https://github.com/matrix-org/matrix-spec/issues/2055)) +- Clarify which rooms are returned from `/hierarchy`. ([#2064](https://github.com/matrix-org/matrix-spec/issues/2064)) +- Clients can choose which history visibility options they offer to users when creating rooms. ([#2072](https://github.com/matrix-org/matrix-spec/issues/2072)) + + +## Server-Server API + +**Spec Clarifications** + +- Remove the `origin` field in `PUT /send_join` responses, because it was never sent in the first place. ([#2050](https://github.com/matrix-org/matrix-spec/issues/2050)) +- Clarify that `m.join_rules` should be in the `auth_events` of an `m.room.member` event with a `membership` of `knock`. ([#2063](https://github.com/matrix-org/matrix-spec/issues/2063)) +- Remove an erroneous `room_id` field in a few examples. ([#2076](https://github.com/matrix-org/matrix-spec/issues/2076)) + + +## Application Service API + +No significant changes. + + +## Identity Service API + +No significant changes. + + +## Push Gateway API + +No significant changes. + + +## Room Versions + +**Backwards Compatible Changes** + +- Update the default room version to 11, as per [MSC4239](https://github.com/matrix-org/matrix-spec-proposals/pull/4239). ([#2105](https://github.com/matrix-org/matrix-spec/issues/2105)) + +**Spec Clarifications** + +- For room versions 6 and 7, clarify in the authorization rules that `m.federate` must be checked and that events with rejected auth events must be rejected, for parity with all the other room versions. ([#2065](https://github.com/matrix-org/matrix-spec/issues/2065)) +- Fix various typos throughout the specification. ([#2066](https://github.com/matrix-org/matrix-spec/issues/2066)) +- Refactor PDU definitions to reduce duplication. ([#2070](https://github.com/matrix-org/matrix-spec/issues/2070)) +- Clarify the maximum `depth` value for room versions 6, 7, 8, 9, 10, and 11. ([#2114](https://github.com/matrix-org/matrix-spec/issues/2114)) + + +## Appendices + +**Spec Clarifications** + +- Clarify that arbitrary unicode is allowed in user/room IDs and room aliases. ([#1506](https://github.com/matrix-org/matrix-spec/issues/1506)) + + +## Internal Changes/Tooling + +**Spec Clarifications** + +- Generate the changelog release info with Hugo, rather than the changelog generation script. ([#2033](https://github.com/matrix-org/matrix-spec/issues/2033)) +- Update release steps documentation. ([#2041](https://github.com/matrix-org/matrix-spec/issues/2041)) +- Remove unused `release_date` from Hugo config. ([#2042](https://github.com/matrix-org/matrix-spec/issues/2042)) +- Clarify that v1.0 of Matrix was a release prior to the current global versioning system. ([#2045](https://github.com/matrix-org/matrix-spec/issues/2045)) +- Fix syntax highlighting and click-to-copy buttons for code blocks by purging less CSS. ([#2049](https://github.com/matrix-org/matrix-spec/issues/2049)) +- Fix the version of the Identity Service API when Matrix 1.0 was introduced. ([#2061](https://github.com/matrix-org/matrix-spec/issues/2061)) +- Fix parsing of nested slices in `resolve-refs` and `resolve-allof` partials. ([#2069](https://github.com/matrix-org/matrix-spec/issues/2069)) +- Deduplicate the definition of `RoomKeysUpdateResponse`. ([#2073](https://github.com/matrix-org/matrix-spec/issues/2073)) +- Deduplicate the definitions of `Invite3pid`. ([#2074](https://github.com/matrix-org/matrix-spec/issues/2074)) +- Support more locations for examples in OpenAPI definitions and JSON schemas. ([#2076](https://github.com/matrix-org/matrix-spec/issues/2076)) +- Add link to the git commit for the unstable changelog. ([#2078](https://github.com/matrix-org/matrix-spec/issues/2078))