Describe new global specification versioning (#3420)

* Update versioning specification for Matrix

As per [MSC2844](https://github.com/matrix-org/matrix-doc/pull/2844)

* Mention vX versioning in /versions

* Changelog
This commit is contained in:
Travis Ralston 2021-10-12 11:06:51 -06:00 committed by GitHub
parent 2fc3982568
commit 2d98cd3084
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 78 additions and 39 deletions

View file

@ -29,10 +29,9 @@ paths:
description: |-
Gets the versions of the specification supported by the server.
Values will take the form `rX.Y.Z`.
Only the latest `Z` value will be reported for each supported `X.Y` value.
i.e. if the server implements `r0.0.0`, `r0.0.1`, and `r1.2.0`, it will report `r0.0.1` and `r1.2.0`.
Values will take the form `vX.Y` or `rX.Y.Z` in historical cases. See
[the Specification Versioning](../#specification-versions) for more
information.
The server may additionally advertise experimental features it supports
through `unstable_features`. These features should be namespaced and
@ -52,7 +51,7 @@ paths:
description: The versions supported by the server.
examples:
application/json: {
"versions": ["r0.0.1"],
"versions": ["r0.0.1", "v1.1"],
"unstable_features": {
"org.example.my_feature": true
}