Deprecate changing message endpoint in non change edit context
Change-Id: Ia1aca9f33d5a31a109df33756ae5d46800792b82
diff --git a/Documentation/rest-api-changes.txt b/Documentation/rest-api-changes.txt
index 2a4c141..db358f3 100644
--- a/Documentation/rest-api-changes.txt
+++ b/Documentation/rest-api-changes.txt
@@ -2995,7 +2995,10 @@
'POST /changes/link:#change-id[\{change-id\}]/revisions/link:#revision-id[\{revision-id\}]/message'
--
-Edit commit message.
+Edit commit message. *Warning*: as of Gerrit 2.11 this REST endpoint is
+deprecated and will be removed in a future version.
+Use link:#put-change-edit-message[put commit message] and
+link:#publish-edit[publish edit] instead.
The commit message must be provided in the request body inside a
link:#cherrypick-input[CherryPickInput] entity.
