diff --git a/changelogs/application_service/newsfragments/1744.clarification b/changelogs/application_service/newsfragments/1744.clarification deleted file mode 100644 index 908c48ab..00000000 --- a/changelogs/application_service/newsfragments/1744.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that the `/login` and `/register` endpoints should fail when using the `m.login.application_service` login type without a valid `as_token`. diff --git a/changelogs/client_server/newsfragments/1629.clarification b/changelogs/client_server/newsfragments/1629.clarification deleted file mode 100644 index 81ed5aaa..00000000 --- a/changelogs/client_server/newsfragments/1629.clarification +++ /dev/null @@ -1 +0,0 @@ -The [strike](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/strike) element is deprecated in the HTML spec. Clients should prefer [s](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/s) instead. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1685.clarification b/changelogs/client_server/newsfragments/1685.clarification deleted file mode 100644 index 8090d817..00000000 --- a/changelogs/client_server/newsfragments/1685.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that read receipts should be batched by thread as well as by room. diff --git a/changelogs/client_server/newsfragments/1687.clarification b/changelogs/client_server/newsfragments/1687.clarification deleted file mode 100644 index 09bacd28..00000000 --- a/changelogs/client_server/newsfragments/1687.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that threads can be created based on replies. diff --git a/changelogs/client_server/newsfragments/1690.clarification b/changelogs/client_server/newsfragments/1690.clarification deleted file mode 100644 index e24a08cf..00000000 --- a/changelogs/client_server/newsfragments/1690.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify in the reply fallbacks example that the prefix sequence should be repeated for each line. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1695.clarification b/changelogs/client_server/newsfragments/1695.clarification deleted file mode 100644 index 32d9bb51..00000000 --- a/changelogs/client_server/newsfragments/1695.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify the format of account data objects for secret storage. diff --git a/changelogs/client_server/newsfragments/1712.clarification b/changelogs/client_server/newsfragments/1712.clarification deleted file mode 100644 index 9e1523c5..00000000 --- a/changelogs/client_server/newsfragments/1712.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that the key backup MAC is implemented incorrectly and does not pass the ciphertext through HMAC-SHA-256. diff --git a/changelogs/client_server/newsfragments/1715.clarification b/changelogs/client_server/newsfragments/1715.clarification deleted file mode 100644 index a1d30432..00000000 --- a/changelogs/client_server/newsfragments/1715.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify one-time key and fallback key types in examples. diff --git a/changelogs/client_server/newsfragments/1719.clarification b/changelogs/client_server/newsfragments/1719.clarification deleted file mode 100644 index 031e1e41..00000000 --- a/changelogs/client_server/newsfragments/1719.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that the HKDF calculation for SAS uses base64-encoded keys rather than the raw key bytes. diff --git a/changelogs/client_server/newsfragments/1720.clarification b/changelogs/client_server/newsfragments/1720.clarification deleted file mode 100644 index e8c8a623..00000000 --- a/changelogs/client_server/newsfragments/1720.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify how to perform the ECDH exchange in step 12 of the SAS process. diff --git a/changelogs/client_server/newsfragments/1728.feature b/changelogs/client_server/newsfragments/1728.feature deleted file mode 100644 index 98d055fb..00000000 --- a/changelogs/client_server/newsfragments/1728.feature +++ /dev/null @@ -1 +0,0 @@ -Allow `/versions` to optionally accept authentication, as per [MSC4026](https://github.com/matrix-org/matrix-spec-proposals/pull/4026). diff --git a/changelogs/client_server/newsfragments/1730.feature b/changelogs/client_server/newsfragments/1730.feature deleted file mode 100644 index 673f7515..00000000 --- a/changelogs/client_server/newsfragments/1730.feature +++ /dev/null @@ -1 +0,0 @@ -Add local erasure requests, as per [MSC4025](https://github.com/matrix-org/matrix-spec-proposals/pull/4025). diff --git a/changelogs/client_server/newsfragments/1731.feature b/changelogs/client_server/newsfragments/1731.feature deleted file mode 100644 index fa952762..00000000 --- a/changelogs/client_server/newsfragments/1731.feature +++ /dev/null @@ -1 +0,0 @@ -Use the `body` field as optional media caption, as per [MSC2530](https://github.com/matrix-org/matrix-spec-proposals/pull/2530). \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1732.clarification b/changelogs/client_server/newsfragments/1732.clarification deleted file mode 100644 index 61e74c6c..00000000 --- a/changelogs/client_server/newsfragments/1732.clarification +++ /dev/null @@ -1 +0,0 @@ -Document the deprecation policy of HTML tags, as per [MSC4077](https://github.com/matrix-org/matrix-spec-proposals/pull/4077). \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1733.feature b/changelogs/client_server/newsfragments/1733.feature deleted file mode 100644 index a2740ea7..00000000 --- a/changelogs/client_server/newsfragments/1733.feature +++ /dev/null @@ -1 +0,0 @@ -Add server support discovery endpoint, as per [MSC1929](https://github.com/matrix-org/matrix-spec-proposals/pull/1929). \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1734.clarification b/changelogs/client_server/newsfragments/1734.clarification deleted file mode 100644 index 32d9bb51..00000000 --- a/changelogs/client_server/newsfragments/1734.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify the format of account data objects for secret storage. diff --git a/changelogs/client_server/newsfragments/1735.feature b/changelogs/client_server/newsfragments/1735.feature deleted file mode 100644 index 1d764142..00000000 --- a/changelogs/client_server/newsfragments/1735.feature +++ /dev/null @@ -1 +0,0 @@ -Add support for multi-stream VoIP, as per [MSC3077](https://github.com/matrix-org/matrix-spec-proposals/pull/3077). \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1737.feature b/changelogs/client_server/newsfragments/1737.feature deleted file mode 100644 index e8d31dec..00000000 --- a/changelogs/client_server/newsfragments/1737.feature +++ /dev/null @@ -1 +0,0 @@ -Specify that the `Retry-After` header may be used to rate-limit a client, as per [MSC4041](https://github.com/matrix-org/matrix-spec-proposals/pull/4041). diff --git a/changelogs/client_server/newsfragments/1739.clarification b/changelogs/client_server/newsfragments/1739.clarification deleted file mode 100644 index da43cefb..00000000 --- a/changelogs/client_server/newsfragments/1739.clarification +++ /dev/null @@ -1 +0,0 @@ -The [font](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/font) element is deprecated in the HTML spec. Clients should prefer [span](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span) with the `data-mx-bg-color` and `data-mx-color` attributes instead. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1740.clarification b/changelogs/client_server/newsfragments/1740.clarification deleted file mode 100644 index 1760ac9f..00000000 --- a/changelogs/client_server/newsfragments/1740.clarification +++ /dev/null @@ -1 +0,0 @@ -Disambiguate uses of `PublicRoomsChunk` in the `GET /hierarchy` endpoint. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1742.clarification b/changelogs/client_server/newsfragments/1742.clarification deleted file mode 100644 index 84f21b9e..00000000 --- a/changelogs/client_server/newsfragments/1742.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that `sdpMid` and `sdpMLineIndex` are not required in `m.call.candidates`. \ No newline at end of file diff --git a/changelogs/client_server/newsfragments/1746.feature b/changelogs/client_server/newsfragments/1746.feature deleted file mode 100644 index d81e46ec..00000000 --- a/changelogs/client_server/newsfragments/1746.feature +++ /dev/null @@ -1 +0,0 @@ -Add support for recursion on the `GET /relations` endpoints, as per [MSC3981](https://github.com/matrix-org/matrix-spec-proposals/pull/3981). diff --git a/changelogs/client_server/newsfragments/1748.clarification b/changelogs/client_server/newsfragments/1748.clarification deleted file mode 100644 index 3ccb2333..00000000 --- a/changelogs/client_server/newsfragments/1748.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix various typos throughout the specification. diff --git a/changelogs/client_server/newsfragments/1756.clarification b/changelogs/client_server/newsfragments/1756.clarification deleted file mode 100644 index 918e87c1..00000000 --- a/changelogs/client_server/newsfragments/1756.clarification +++ /dev/null @@ -1 +0,0 @@ -Clearly indicate that each `Content-Type` may have distinct behaviour on non-JSON requests/responses. diff --git a/changelogs/client_server/newsfragments/1763.clarification b/changelogs/client_server/newsfragments/1763.clarification deleted file mode 100644 index a4db76dd..00000000 --- a/changelogs/client_server/newsfragments/1763.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that the `m.push_rules` account data type cannot be set using the `/account_data` API, as per [MSC4010](https://github.com/matrix-org/matrix-spec-proposals/pull/4010). diff --git a/changelogs/internal/newsfragments/1680.clarification b/changelogs/internal/newsfragments/1680.clarification deleted file mode 100644 index 16352364..00000000 --- a/changelogs/internal/newsfragments/1680.clarification +++ /dev/null @@ -1 +0,0 @@ -Update the spec release process. \ No newline at end of file diff --git a/changelogs/internal/newsfragments/1697.clarification b/changelogs/internal/newsfragments/1697.clarification deleted file mode 100644 index d238b2e9..00000000 --- a/changelogs/internal/newsfragments/1697.clarification +++ /dev/null @@ -1 +0,0 @@ -Minor clarifications to the contributing guide. diff --git a/changelogs/internal/newsfragments/1699.clarification b/changelogs/internal/newsfragments/1699.clarification deleted file mode 100644 index 7d1c0526..00000000 --- a/changelogs/internal/newsfragments/1699.clarification +++ /dev/null @@ -1 +0,0 @@ -Update Docsy to v0.8.0. diff --git a/changelogs/internal/newsfragments/1713.clarification b/changelogs/internal/newsfragments/1713.clarification deleted file mode 100644 index c1b999bf..00000000 --- a/changelogs/internal/newsfragments/1713.clarification +++ /dev/null @@ -1 +0,0 @@ -Fix npm release script for `@matrix-org/spec`. diff --git a/changelogs/internal/newsfragments/1718.clarification b/changelogs/internal/newsfragments/1718.clarification deleted file mode 100644 index 75d5948b..00000000 --- a/changelogs/internal/newsfragments/1718.clarification +++ /dev/null @@ -1 +0,0 @@ -Add some clarifications around implementation requirements for MSCs. diff --git a/changelogs/internal/newsfragments/1724.clarification b/changelogs/internal/newsfragments/1724.clarification deleted file mode 100644 index 12be0c5a..00000000 --- a/changelogs/internal/newsfragments/1724.clarification +++ /dev/null @@ -1 +0,0 @@ -Update HTML templates to include links to object schema definitions. diff --git a/changelogs/internal/newsfragments/1745.clarification b/changelogs/internal/newsfragments/1745.clarification deleted file mode 100644 index acd85892..00000000 --- a/changelogs/internal/newsfragments/1745.clarification +++ /dev/null @@ -1 +0,0 @@ -Factor out all the common parameters of the various `/relations` apis. diff --git a/changelogs/internal/newsfragments/1751.clarification b/changelogs/internal/newsfragments/1751.clarification deleted file mode 100644 index 50c50693..00000000 --- a/changelogs/internal/newsfragments/1751.clarification +++ /dev/null @@ -1 +0,0 @@ -Add support for `$ref` URIs containing fragments in OpenAPI definitions and JSON schemas. diff --git a/changelogs/internal/newsfragments/1754.clarification b/changelogs/internal/newsfragments/1754.clarification deleted file mode 100644 index 50c50693..00000000 --- a/changelogs/internal/newsfragments/1754.clarification +++ /dev/null @@ -1 +0,0 @@ -Add support for `$ref` URIs containing fragments in OpenAPI definitions and JSON schemas. diff --git a/changelogs/internal/newsfragments/1762.clarification b/changelogs/internal/newsfragments/1762.clarification deleted file mode 100644 index 7d1c0526..00000000 --- a/changelogs/internal/newsfragments/1762.clarification +++ /dev/null @@ -1 +0,0 @@ -Update Docsy to v0.8.0. diff --git a/changelogs/room_versions/newsfragments/1717.clarification b/changelogs/room_versions/newsfragments/1717.clarification deleted file mode 100644 index 80bc9d55..00000000 --- a/changelogs/room_versions/newsfragments/1717.clarification +++ /dev/null @@ -1 +0,0 @@ -For room versions 7 through 11: Clarify that `invite->knock` is not a legal transition. \ No newline at end of file diff --git a/changelogs/server_server/newsfragments/1721.clarification b/changelogs/server_server/newsfragments/1721.clarification deleted file mode 100644 index a742501b..00000000 --- a/changelogs/server_server/newsfragments/1721.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify Server-Server API request signing example by using the `POST` HTTP method, as `GET` requests don't have request bodies. diff --git a/changelogs/server_server/newsfragments/1740.clarification b/changelogs/server_server/newsfragments/1740.clarification deleted file mode 100644 index 1760ac9f..00000000 --- a/changelogs/server_server/newsfragments/1740.clarification +++ /dev/null @@ -1 +0,0 @@ -Disambiguate uses of `PublicRoomsChunk` in the `GET /hierarchy` endpoint. \ No newline at end of file diff --git a/changelogs/server_server/newsfragments/1741.clarification b/changelogs/server_server/newsfragments/1741.clarification deleted file mode 100644 index ec31cac1..00000000 --- a/changelogs/server_server/newsfragments/1741.clarification +++ /dev/null @@ -1 +0,0 @@ -Clarify that the `children_state`, `room_type` and `allowed_room_ids` properties in the items of the `children` array of the response of the `GET /hierarchy` endpoint are not required. \ No newline at end of file diff --git a/config.toml b/config.toml index 15a284b5..94ccfd49 100644 --- a/config.toml +++ b/config.toml @@ -59,14 +59,14 @@ privacy_policy = "https://matrix.org/legal/privacy-notice" [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. CI will set these values here automatically when a release git tag (i.e `v1.5`) is created. -# major = "1" -# minor = "9" -# release_date = "November 29, 2023" +major = "1" +minor = "10" +release_date = "March 22, 2024" # User interface configuration [params.ui] diff --git a/content/changelog/v1.10.md b/content/changelog/v1.10.md new file mode 100644 index 00000000..16b3217d --- /dev/null +++ b/content/changelog/v1.10.md @@ -0,0 +1,102 @@ +--- +date: 2024-03-22T09:59:45-06:00 +--- + + +## v1.10 + + + + +
Git commithttps://github.com/matrix-org/matrix-spec/tree/v1.10
Release dateMarch 22, 2024
+ + + +### Client-Server API + +**Backwards Compatible Changes** + +- Allow `/versions` to optionally accept authentication, as per [MSC4026](https://github.com/matrix-org/matrix-spec-proposals/pull/4026). ([#1728](https://github.com/matrix-org/matrix-spec/issues/1728)) +- Add local erasure requests, as per [MSC4025](https://github.com/matrix-org/matrix-spec-proposals/pull/4025). ([#1730](https://github.com/matrix-org/matrix-spec/issues/1730)) +- Use the `body` field as optional media caption, as per [MSC2530](https://github.com/matrix-org/matrix-spec-proposals/pull/2530). ([#1731](https://github.com/matrix-org/matrix-spec/issues/1731)) +- Add server support discovery endpoint, as per [MSC1929](https://github.com/matrix-org/matrix-spec-proposals/pull/1929). ([#1733](https://github.com/matrix-org/matrix-spec/issues/1733)) +- Add support for multi-stream VoIP, as per [MSC3077](https://github.com/matrix-org/matrix-spec-proposals/pull/3077). ([#1735](https://github.com/matrix-org/matrix-spec/issues/1735)) +- Specify that the `Retry-After` header may be used to rate-limit a client, as per [MSC4041](https://github.com/matrix-org/matrix-spec-proposals/pull/4041). ([#1737](https://github.com/matrix-org/matrix-spec/issues/1737)) +- Add support for recursion on the `GET /relations` endpoints, as per [MSC3981](https://github.com/matrix-org/matrix-spec-proposals/pull/3981). ([#1746](https://github.com/matrix-org/matrix-spec/issues/1746)) + +**Spec Clarifications** + +- The [strike](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/strike) element is deprecated in the HTML spec. Clients should prefer [s](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/s) instead. ([#1629](https://github.com/matrix-org/matrix-spec/issues/1629)) +- Clarify that read receipts should be batched by thread as well as by room. ([#1685](https://github.com/matrix-org/matrix-spec/issues/1685)) +- Clarify that threads can be created based on replies. ([#1687](https://github.com/matrix-org/matrix-spec/issues/1687)) +- Clarify in the reply fallbacks example that the prefix sequence should be repeated for each line. ([#1690](https://github.com/matrix-org/matrix-spec/issues/1690)) +- Clarify the format of account data objects for secret storage. ([#1695](https://github.com/matrix-org/matrix-spec/issues/1695), [#1734](https://github.com/matrix-org/matrix-spec/issues/1734)) +- Clarify that the key backup MAC is implemented incorrectly and does not pass the ciphertext through HMAC-SHA-256. ([#1712](https://github.com/matrix-org/matrix-spec/issues/1712)) +- Clarify one-time key and fallback key types in examples. ([#1715](https://github.com/matrix-org/matrix-spec/issues/1715)) +- Clarify that the HKDF calculation for SAS uses base64-encoded keys rather than the raw key bytes. ([#1719](https://github.com/matrix-org/matrix-spec/issues/1719)) +- Clarify how to perform the ECDH exchange in step 12 of the SAS process. ([#1720](https://github.com/matrix-org/matrix-spec/issues/1720)) +- Document the deprecation policy of HTML tags, as per [MSC4077](https://github.com/matrix-org/matrix-spec-proposals/pull/4077). ([#1732](https://github.com/matrix-org/matrix-spec/issues/1732)) +- The [font](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/font) element is deprecated in the HTML spec. Clients should prefer [span](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span) with the `data-mx-bg-color` and `data-mx-color` attributes instead. ([#1739](https://github.com/matrix-org/matrix-spec/issues/1739)) +- Disambiguate uses of `PublicRoomsChunk` in the `GET /hierarchy` endpoint. ([#1740](https://github.com/matrix-org/matrix-spec/issues/1740)) +- Clarify that `sdpMid` and `sdpMLineIndex` are not required in `m.call.candidates`. ([#1742](https://github.com/matrix-org/matrix-spec/issues/1742)) +- Fix various typos throughout the specification. ([#1748](https://github.com/matrix-org/matrix-spec/issues/1748)) +- Clearly indicate that each `Content-Type` may have distinct behaviour on non-JSON requests/responses. ([#1756](https://github.com/matrix-org/matrix-spec/issues/1756)) +- Clarify that the `m.push_rules` account data type cannot be set using the `/account_data` API, as per [MSC4010](https://github.com/matrix-org/matrix-spec-proposals/pull/4010). ([#1763](https://github.com/matrix-org/matrix-spec/issues/1763)) + + +### Server-Server API + +**Spec Clarifications** + +- Clarify Server-Server API request signing example by using the `POST` HTTP method, as `GET` requests don't have request bodies. ([#1721](https://github.com/matrix-org/matrix-spec/issues/1721)) +- Disambiguate uses of `PublicRoomsChunk` in the `GET /hierarchy` endpoint. ([#1740](https://github.com/matrix-org/matrix-spec/issues/1740)) +- Clarify that the `children_state`, `room_type` and `allowed_room_ids` properties in the items of the `children` array of the response of the `GET /hierarchy` endpoint are not required. ([#1741](https://github.com/matrix-org/matrix-spec/issues/1741)) + + +### Application Service API + +**Spec Clarifications** + +- Clarify that the `/login` and `/register` endpoints should fail when using the `m.login.application_service` login type without a valid `as_token`. ([#1744](https://github.com/matrix-org/matrix-spec/issues/1744)) + + +### Identity Service API + +No significant changes. + + +### Push Gateway API + +No significant changes. + + +### Room Versions + +**Spec Clarifications** + +- For room versions 7 through 11: Clarify that `invite->knock` is not a legal transition. ([#1717](https://github.com/matrix-org/matrix-spec/issues/1717)) + + +### Appendices + +No significant changes. + + +### Internal Changes/Tooling + +**Spec Clarifications** + +- Update the spec release process. ([#1680](https://github.com/matrix-org/matrix-spec/issues/1680)) +- Minor clarifications to the contributing guide. ([#1697](https://github.com/matrix-org/matrix-spec/issues/1697)) +- Update Docsy to v0.8.0. ([#1699](https://github.com/matrix-org/matrix-spec/issues/1699), [#1762](https://github.com/matrix-org/matrix-spec/issues/1762)) +- Fix npm release script for `@matrix-org/spec`. ([#1713](https://github.com/matrix-org/matrix-spec/issues/1713)) +- Add some clarifications around implementation requirements for MSCs. ([#1718](https://github.com/matrix-org/matrix-spec/issues/1718)) +- Update HTML templates to include links to object schema definitions. ([#1724](https://github.com/matrix-org/matrix-spec/issues/1724)) +- Factor out all the common parameters of the various `/relations` apis. ([#1745](https://github.com/matrix-org/matrix-spec/issues/1745)) +- Add support for `$ref` URIs containing fragments in OpenAPI definitions and JSON schemas. ([#1751](https://github.com/matrix-org/matrix-spec/issues/1751), [#1754](https://github.com/matrix-org/matrix-spec/issues/1754))