Merge pull request #3199 from uhoreg/deprecate_verification_start_spec

Deprecate verifications that don't begin with a request.
matrix-org · Aug 27, 2021 · c4e9e90 · c4e9e90
2 parents 96b86b0 + b3b6fb3
commit c4e9e90
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 1 deletion.
diff --git a/changelogs/client_server/newsfragments/3199.deprecaation b/changelogs/client_server/newsfragments/3199.deprecaation
@@ -0,0 +1 @@
+Deprecate starting verifications that don't start with `m.key.verification.request` as per [MSC3122](https://github.com/matrix-org/matrix-doc/pull/3122).
diff --git a/content/client-server-api/modules/end_to_end_encryption.md b/content/client-server-api/modules/end_to_end_encryption.md
@@ -528,7 +528,9 @@ method, then the verification should be cancelled with a `code` of
 `m.unexpected_message`.
 
 An `m.key.verification.start` message can also be sent independently of any
-request, specifying the verification method to use.
+request, specifying the verification method to use. This behaviour is
+deprecated, and new clients should not begin verifications in this way.
+However, clients should handle such verifications started by other clients.
 
 Individual verification methods may add additional steps, events, and
 properties to the verification messages. Event types for methods defined
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Deprecate starting verifications that don't start with `m.key.verification.request` as per [MSC3122](https://github.com/matrix-org/matrix-doc/pull/3122).