diff --git a/changelogs/application_service/newsfragments/2213.clarification b/changelogs/application_service/newsfragments/2213.clarification deleted file mode 100644 index a8c06342..00000000 --- a/changelogs/application_service/newsfragments/2213.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix JSON formatting in the "Server admin style permissions" examples. diff --git a/changelogs/application_service/newsfragments/2221.feature b/changelogs/application_service/newsfragments/2221.feature deleted file mode 100644 index 400d98ef..00000000 --- a/changelogs/application_service/newsfragments/2221.feature +++ /dev/null @@ -1 +0,0 @@ -Allow application services to masquerade as specific devices belonging to users, as per [MSC4326](https://github.com/matrix-org/matrix-spec-proposals/pull/4326). \ No newline at end of file diff --git a/changelogs/application_service/newsfragments/2267.feature b/changelogs/application_service/newsfragments/2267.feature deleted file mode 100644 index 92a03203..00000000 --- a/changelogs/application_service/newsfragments/2267.feature +++ /dev/null @@ -1 +0,0 @@ -Allow application services to manage devices and register users without the legacy authentication API, as per [MSC4190](https://github.com/matrix-org/matrix-spec-proposals/pull/4190). diff --git a/changelogs/client_server/newsfragments/2186.removal b/changelogs/client_server/newsfragments/2186.removal deleted file mode 100644 index c40f001f..00000000 --- a/changelogs/client_server/newsfragments/2186.removal +++ /dev/null @@ -1 +0,0 @@ -Remove legacy mentions, as per [MSC4210](https://github.com/matrix-org/matrix-spec-proposals/issues/4210). diff --git a/changelogs/client_server/newsfragments/2214.clarification b/changelogs/client_server/newsfragments/2214.clarification deleted file mode 100644 index 50121eaa..00000000 --- a/changelogs/client_server/newsfragments/2214.clarification +++ /dev/null @@ -1 +0,0 @@ -Push rule IDs are globally unique within their kind. diff --git a/changelogs/client_server/newsfragments/2215.clarification b/changelogs/client_server/newsfragments/2215.clarification deleted file mode 100644 index f76c952d..00000000 --- a/changelogs/client_server/newsfragments/2215.clarification +++ /dev/null @@ -1 +0,0 @@ -Don't advertise `creator` field in description of room creation. diff --git a/changelogs/client_server/newsfragments/2216.clarification b/changelogs/client_server/newsfragments/2216.clarification deleted file mode 100644 index a777ad87..00000000 --- a/changelogs/client_server/newsfragments/2216.clarification +++ /dev/null @@ -1 +0,0 @@ -`room_id` is required for peeking via `/_matrix/client/v3/events`. diff --git a/changelogs/client_server/newsfragments/2217.clarification b/changelogs/client_server/newsfragments/2217.clarification deleted file mode 100644 index ea895054..00000000 --- a/changelogs/client_server/newsfragments/2217.clarification +++ /dev/null @@ -1 +0,0 @@ -The `server-name` segment of MXC URIs is sanitised differently from the `media-id` segment. diff --git a/changelogs/client_server/newsfragments/2221.feature b/changelogs/client_server/newsfragments/2221.feature deleted file mode 100644 index 400d98ef..00000000 --- a/changelogs/client_server/newsfragments/2221.feature +++ /dev/null @@ -1 +0,0 @@ -Allow application services to masquerade as specific devices belonging to users, as per [MSC4326](https://github.com/matrix-org/matrix-spec-proposals/pull/4326). \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/2223.clarification b/changelogs/client_server/newsfragments/2223.clarification deleted file mode 100644 index 401a1f95..00000000 --- a/changelogs/client_server/newsfragments/2223.clarification +++ /dev/null @@ -1 +0,0 @@ -Add note to each endpoint that uses capability negotiation. diff --git a/changelogs/client_server/newsfragments/2224.clarification b/changelogs/client_server/newsfragments/2224.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/2224.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/2225.clarification b/changelogs/client_server/newsfragments/2225.clarification deleted file mode 100644 index 6a62eb99..00000000 --- a/changelogs/client_server/newsfragments/2225.clarification +++ /dev/null @@ -1 +0,0 @@ -Additional OpenGraph properties can be present in URL previews. diff --git a/changelogs/client_server/newsfragments/2227.clarification b/changelogs/client_server/newsfragments/2227.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/2227.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/2231.clarification b/changelogs/client_server/newsfragments/2231.clarification deleted file mode 100644 index 58343ac0..00000000 --- a/changelogs/client_server/newsfragments/2231.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify the special casing of membership events and redactions in power levels. diff --git a/changelogs/client_server/newsfragments/2232.clarification b/changelogs/client_server/newsfragments/2232.clarification deleted file mode 100644 index 78304051..00000000 --- a/changelogs/client_server/newsfragments/2232.clarification +++ /dev/null @@ -1 +0,0 @@ -`M_RESOURCE_LIMIT_EXCEEDED` is now listed as a common error code. diff --git a/changelogs/client_server/newsfragments/2233.clarification b/changelogs/client_server/newsfragments/2233.clarification deleted file mode 100644 index 9c4afa28..00000000 --- a/changelogs/client_server/newsfragments/2233.clarification +++ /dev/null @@ -1 +0,0 @@ -Add `m.login.terms` to enumeration of authentication types. diff --git a/changelogs/client_server/newsfragments/2234.feature b/changelogs/client_server/newsfragments/2234.feature deleted file mode 100644 index 2dd33f67..00000000 --- a/changelogs/client_server/newsfragments/2234.feature +++ /dev/null @@ -1 +0,0 @@ -Add the `m.oauth` authentication type for User-Interactive Authentication as per [MSC4312](https://github.com/matrix-org/matrix-spec-proposals/pull/4312). diff --git a/changelogs/client_server/newsfragments/2240.clarification b/changelogs/client_server/newsfragments/2240.clarification deleted file mode 100644 index 07081f28..00000000 --- a/changelogs/client_server/newsfragments/2240.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify how to use `state_after` ahead of declaring full support for its spec version. diff --git a/changelogs/client_server/newsfragments/2245.clarification b/changelogs/client_server/newsfragments/2245.clarification deleted file mode 100644 index 2d0453a2..00000000 --- a/changelogs/client_server/newsfragments/2245.clarification +++ /dev/null @@ -1 +0,0 @@ -`device_one_time_keys_count` is only optional if no unclaimed one-time keys exist. diff --git a/changelogs/client_server/newsfragments/2246.clarification b/changelogs/client_server/newsfragments/2246.clarification deleted file mode 100644 index 7d2625a6..00000000 --- a/changelogs/client_server/newsfragments/2246.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that servers may choose not to use `M_USER_DEACTIVATED` at login time, for example for privacy reasons when they can't authenticate deactivated users. diff --git a/changelogs/client_server/newsfragments/2250.clarification b/changelogs/client_server/newsfragments/2250.clarification deleted file mode 100644 index 12efe875..00000000 --- a/changelogs/client_server/newsfragments/2250.clarification +++ /dev/null @@ -1 +0,0 @@ -Minor grammatical fix in the Secrets module description. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/2255.clarification b/changelogs/client_server/newsfragments/2255.clarification deleted file mode 100644 index 4429fccf..00000000 --- a/changelogs/client_server/newsfragments/2255.clarification +++ /dev/null @@ -1 +0,0 @@ -Usage of the `event_id_only` format for push notifications is not mandatory. diff --git a/changelogs/client_server/newsfragments/2267.feature b/changelogs/client_server/newsfragments/2267.feature deleted file mode 100644 index 92a03203..00000000 --- a/changelogs/client_server/newsfragments/2267.feature +++ /dev/null @@ -1 +0,0 @@ -Allow application services to manage devices and register users without the legacy authentication API, as per [MSC4190](https://github.com/matrix-org/matrix-spec-proposals/pull/4190). diff --git a/changelogs/internal/newsfragments/2219.clarification b/changelogs/internal/newsfragments/2219.clarification deleted file mode 100644 index ef0721b4..00000000 --- a/changelogs/internal/newsfragments/2219.clarification +++ /dev/null @@ -1 +0,0 @@ -Swapped icon for X (fka. twitter) to updated logo in footer. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2226.clarification b/changelogs/internal/newsfragments/2226.clarification deleted file mode 100644 index 68758818..00000000 --- a/changelogs/internal/newsfragments/2226.clarification +++ /dev/null @@ -1 +0,0 @@ -Inline Olm & Megolm specifications. diff --git a/changelogs/internal/newsfragments/2238.clarification b/changelogs/internal/newsfragments/2238.clarification deleted file mode 100644 index b91abc53..00000000 --- a/changelogs/internal/newsfragments/2238.clarification +++ /dev/null @@ -1 +0,0 @@ -Silence failing redocly-cli rule. diff --git a/changelogs/internal/newsfragments/2239.clarification b/changelogs/internal/newsfragments/2239.clarification deleted file mode 100644 index 6b8cf712..00000000 --- a/changelogs/internal/newsfragments/2239.clarification +++ /dev/null @@ -1 +0,0 @@ -Use NPM Trusted Publishers for publishing `@matrix-org/spec` to npm. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2241.clarification b/changelogs/internal/newsfragments/2241.clarification deleted file mode 100644 index 68758818..00000000 --- a/changelogs/internal/newsfragments/2241.clarification +++ /dev/null @@ -1 +0,0 @@ -Inline Olm & Megolm specifications. diff --git a/changelogs/internal/newsfragments/2242.clarification b/changelogs/internal/newsfragments/2242.clarification deleted file mode 100644 index 68758818..00000000 --- a/changelogs/internal/newsfragments/2242.clarification +++ /dev/null @@ -1 +0,0 @@ -Inline Olm & Megolm specifications. diff --git a/changelogs/internal/newsfragments/2256.clarification b/changelogs/internal/newsfragments/2256.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2256.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/internal/newsfragments/2258.clarification b/changelogs/internal/newsfragments/2258.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2258.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/internal/newsfragments/2259.clarification b/changelogs/internal/newsfragments/2259.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2259.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/internal/newsfragments/2260.clarification b/changelogs/internal/newsfragments/2260.clarification deleted file mode 100644 index de578d64..00000000 --- a/changelogs/internal/newsfragments/2260.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2261.clarification b/changelogs/internal/newsfragments/2261.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2261.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/internal/newsfragments/2262.clarification b/changelogs/internal/newsfragments/2262.clarification deleted file mode 100644 index 117c2bec..00000000 --- a/changelogs/internal/newsfragments/2262.clarification +++ /dev/null @@ -1 +0,0 @@ -Add a list of endpoints to the top of each spec page. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/2264.clarification b/changelogs/internal/newsfragments/2264.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2264.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/internal/newsfragments/2268.clarification b/changelogs/internal/newsfragments/2268.clarification deleted file mode 100644 index 468f55d5..00000000 --- a/changelogs/internal/newsfragments/2268.clarification +++ /dev/null @@ -1 +0,0 @@ -Add version picker in the navbar. diff --git a/changelogs/room_versions/newsfragments/2220.clarification b/changelogs/room_versions/newsfragments/2220.clarification deleted file mode 100644 index 4141e31a..00000000 --- a/changelogs/room_versions/newsfragments/2220.clarification +++ /dev/null @@ -1 +0,0 @@ -In room versions 8 through 12, clarify that "sufficient permission to invite users" on restricted joins also includes being a joined member of the room. \ No newline at end of file diff --git a/changelogs/room_versions/newsfragments/2249.clarification b/changelogs/room_versions/newsfragments/2249.clarification deleted file mode 100644 index 7578edc3..00000000 --- a/changelogs/room_versions/newsfragments/2249.clarification +++ /dev/null @@ -1 +0,0 @@ -In room versions 3 through 12, clarify that when you have the power to redact, it is possible to redact events that you don't have the power to send. \ No newline at end of file diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml index b09b9562..a1501ac1 100644 --- a/config/_default/hugo.toml +++ b/config/_default/hugo.toml @@ -70,13 +70,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 = "16" +major = "1" +minor = "17" [[params.versions]] # We must include this parameter to enable docsy's version picker in the navbar. The picker diff --git a/content/changelog/v1.17.md b/content/changelog/v1.17.md new file mode 100644 index 00000000..3597f7ba --- /dev/null +++ b/content/changelog/v1.17.md @@ -0,0 +1,92 @@ +--- +title: v1.17 Changelog +linkTitle: v1.17 +type: docs +layout: changelog +outputs: + - html + - checklist +date: 2025-12-18 +--- + +## Client-Server API + +**Removed Endpoints** + +- Remove legacy mentions, as per [MSC4210](https://github.com/matrix-org/matrix-spec-proposals/issues/4210). ([#2186](https://github.com/matrix-org/matrix-spec/issues/2186)) + +**Backwards Compatible Changes** + +- Allow application services to masquerade as specific devices belonging to users, as per [MSC4326](https://github.com/matrix-org/matrix-spec-proposals/pull/4326). ([#2221](https://github.com/matrix-org/matrix-spec/issues/2221)) +- Add the `m.oauth` authentication type for User-Interactive Authentication as per [MSC4312](https://github.com/matrix-org/matrix-spec-proposals/pull/4312). ([#2234](https://github.com/matrix-org/matrix-spec/issues/2234)) +- Allow application services to manage devices and register users without the legacy authentication API, as per [MSC4190](https://github.com/matrix-org/matrix-spec-proposals/pull/4190). ([#2267](https://github.com/matrix-org/matrix-spec/issues/2267)) + +**Spec Clarifications** + +- Push rule IDs are globally unique within their kind. ([#2214](https://github.com/matrix-org/matrix-spec/issues/2214)) +- Don't advertise `creator` field in description of room creation. ([#2215](https://github.com/matrix-org/matrix-spec/issues/2215)) +- `room_id` is required for peeking via `/_matrix/client/v3/events`. ([#2216](https://github.com/matrix-org/matrix-spec/issues/2216)) +- The `server-name` segment of MXC URIs is sanitised differently from the `media-id` segment. ([#2217](https://github.com/matrix-org/matrix-spec/issues/2217)) +- Add note to each endpoint that uses capability negotiation. ([#2223](https://github.com/matrix-org/matrix-spec/issues/2223)) +- Fix various typos throughout the specification. ([#2224](https://github.com/matrix-org/matrix-spec/issues/2224), [#2227](https://github.com/matrix-org/matrix-spec/issues/2227)) +- Additional OpenGraph properties can be present in URL previews. ([#2225](https://github.com/matrix-org/matrix-spec/issues/2225)) +- Clarify the special casing of membership events and redactions in power levels. ([#2231](https://github.com/matrix-org/matrix-spec/issues/2231)) +- `M_RESOURCE_LIMIT_EXCEEDED` is now listed as a common error code. ([#2232](https://github.com/matrix-org/matrix-spec/issues/2232)) +- Add `m.login.terms` to enumeration of authentication types. ([#2233](https://github.com/matrix-org/matrix-spec/issues/2233)) +- Clarify how to use `state_after` ahead of declaring full support for its spec version. ([#2240](https://github.com/matrix-org/matrix-spec/issues/2240)) +- `device_one_time_keys_count` is only optional if no unclaimed one-time keys exist. ([#2245](https://github.com/matrix-org/matrix-spec/issues/2245)) +- Clarify that servers may choose not to use `M_USER_DEACTIVATED` at login time, for example for privacy reasons when they can't authenticate deactivated users. ([#2246](https://github.com/matrix-org/matrix-spec/issues/2246)) +- Minor grammatical fix in the Secrets module description. ([#2250](https://github.com/matrix-org/matrix-spec/issues/2250)) +- Usage of the `event_id_only` format for push notifications is not mandatory. ([#2255](https://github.com/matrix-org/matrix-spec/issues/2255)) + + +## Server-Server API + +No significant changes. + + +## Application Service API + +**Backwards Compatible Changes** + +- Allow application services to masquerade as specific devices belonging to users, as per [MSC4326](https://github.com/matrix-org/matrix-spec-proposals/pull/4326). ([#2221](https://github.com/matrix-org/matrix-spec/issues/2221)) +- Allow application services to manage devices and register users without the legacy authentication API, as per [MSC4190](https://github.com/matrix-org/matrix-spec-proposals/pull/4190). ([#2267](https://github.com/matrix-org/matrix-spec/issues/2267)) + +**Spec Clarifications** + +- Fix JSON formatting in the "Server admin style permissions" examples. ([#2213](https://github.com/matrix-org/matrix-spec/issues/2213)) + + +## Identity Service API + +No significant changes. + + +## Push Gateway API + +No significant changes. + + +## Room Versions + +**Spec Clarifications** + +- In room versions 8 through 12, clarify that "sufficient permission to invite users" on restricted joins also includes being a joined member of the room. ([#2220](https://github.com/matrix-org/matrix-spec/issues/2220)) +- In room versions 3 through 12, clarify that when you have the power to redact, it is possible to redact events that you don't have the power to send. ([#2249](https://github.com/matrix-org/matrix-spec/issues/2249)) + + +## Appendices + +No significant changes. + + +## Internal Changes/Tooling + +**Spec Clarifications** + +- Swapped icon for X (fka. twitter) to updated logo in footer. ([#2219](https://github.com/matrix-org/matrix-spec/issues/2219)) +- Inline Olm & Megolm specifications. ([#2226](https://github.com/matrix-org/matrix-spec/issues/2226), [#2241](https://github.com/matrix-org/matrix-spec/issues/2241), [#2242](https://github.com/matrix-org/matrix-spec/issues/2242)) +- Silence failing redocly-cli rule. ([#2238](https://github.com/matrix-org/matrix-spec/issues/2238)) +- Use NPM Trusted Publishers for publishing `@matrix-org/spec` to npm. ([#2239](https://github.com/matrix-org/matrix-spec/issues/2239)) +- Add version picker in the navbar. ([#2256](https://github.com/matrix-org/matrix-spec/issues/2256), [#2258](https://github.com/matrix-org/matrix-spec/issues/2258), [#2259](https://github.com/matrix-org/matrix-spec/issues/2259), [#2260](https://github.com/matrix-org/matrix-spec/issues/2260), [#2261](https://github.com/matrix-org/matrix-spec/issues/2261), [#2264](https://github.com/matrix-org/matrix-spec/issues/2264), [#2268](https://github.com/matrix-org/matrix-spec/issues/2268)) +- Add a list of endpoints to the top of each spec page. ([#2262](https://github.com/matrix-org/matrix-spec/issues/2262))