Skip to content

Commit

Permalink
Clarify that v1.0 of Matrix was a symbolic release (#2045)
Browse files Browse the repository at this point in the history
Explain that it was a release prior to the current global versioning system.

---------

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
  • Loading branch information
zecakeh and richvdh authored Jan 23, 2025
1 parent cd6ae9e commit 9e0f2aa
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 12 deletions.
1 change: 1 addition & 0 deletions changelogs/internal/newsfragments/2045.clarification
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Clarify that v1.0 of Matrix was a release prior to the current global versioning system.
29 changes: 17 additions & 12 deletions content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

| 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 |

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 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

Expand Down

0 comments on commit 9e0f2aa

Please sign in to comment.