From f5fa7e59241cc7d1907a11e0d194aa597f0c3439 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Thu, 17 Jan 2019 14:05:30 -0700 Subject: [PATCH] Change wording to encourage servers to make reasonable decisions --- api/client-server/versions.yaml | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/api/client-server/versions.yaml b/api/client-server/versions.yaml index 4d0fd49e8..109e852ca 100644 --- a/api/client-server/versions.yaml +++ b/api/client-server/versions.yaml @@ -39,9 +39,12 @@ paths: may optionally include version information within their name if desired. Features listed here are not for optionally toggling parts of the Matrix specification and should only be used to advertise support for a feature - which has not yet landed in the spec. For example, an accepted proposal - for a feature needing implementation would advertise itself here with - the intention of being removed from this list once the spec changes land. + which has not yet landed in the spec. For example, a feature currently + undergoing the proposal process may appear here and eventually be taken + off this list once the feature lands in the spec and the server deems it + reasonable to do so. Servers may wish to keep advertising features here + after they've been released into the spec to give clients a chance to + upgrade appropriately. operationId: getVersions responses: 200: