From 9e0f2aad94bdf9e601283adaef68d6b9d8df7783 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K=C3=A9vin=20Commaille?= <76261501+zecakeh@users.noreply.github.com> Date: Thu, 23 Jan 2025 13:36:41 +0100 Subject: [PATCH] Clarify that v1.0 of Matrix was a symbolic release (#2045) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Explain that it was a release prior to the current global versioning system. --------- Signed-off-by: Kévin Commaille Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> --- .../internal/newsfragments/2045.clarification | 1 + content/_index.md | 25 +++++++++++-------- 2 files changed, 16 insertions(+), 10 deletions(-) create mode 100644 changelogs/internal/newsfragments/2045.clarification diff --git a/changelogs/internal/newsfragments/2045.clarification b/changelogs/internal/newsfragments/2045.clarification new file mode 100644 index 00000000..bfe42c51 --- /dev/null +++ b/changelogs/internal/newsfragments/2045.clarification @@ -0,0 +1 @@ +Clarify that v1.0 of Matrix was a release prior to the current global versioning system. diff --git a/content/_index.md b/content/_index.md index e56eb4d0..ec923303 100644 --- a/content/_index.md +++ b/content/_index.md @@ -504,18 +504,23 @@ For historical reference, the APIs were versioned as `rX.Y.Z` where `X` roughly represents a breaking change, `Y` a backwards-compatible change, and `Z` a patch or insignificant alteration to the API. -`v1.0` of Matrix was released on June 10th, 2019 with the following API -versions: +The current global versioning system was introduced with `v1.1`. +[Matrix 1.0](https://matrix.org/blog/2019/06/11/introducing-matrix-1-0-and-the-matrix-org-foundation/) +did not correspond directly to a specification version; instead, it was based on +the following versions for the individual APIs: -| API/Specification | Version | -|-------------------------|---------| -| Client-Server API | r0.5.0 | -| Server-Server API | r0.1.2 | -| Application Service API | r0.1.1 | -| Identity Service API | r0.1.1 | -| Push Gateway API | r0.1.0 | -| Room Version | v5 | +| API/Specification | Version | +|--------------------------|---------------| +| Client-Server API | r0.5.0 | +| Server-Server API | r0.1.2 | +| Application Service API | r0.1.1 | +| Identity Service API | r0.1.1 | +| Push Gateway API | r0.1.0 | +| Room Versions | 1, 2, 3, 4, 5 | +`v1.0` should **not** be returned by servers in the +[`GET /_matrix/client/versions`](/client-server-api/#get_matrixclientversions) +response. ## License