Merge "Init: Add ability to skip reindex after init" into stable-3.5
diff --git a/Documentation/rest-api-changes.txt b/Documentation/rest-api-changes.txt
index 1a999f1..5df78cc 100644
--- a/Documentation/rest-api-changes.txt
+++ b/Documentation/rest-api-changes.txt
@@ -6266,9 +6266,12 @@
Gerrit also supports an array of other change identifiers.
[NOTE]
-Using these identifiers comes with a performance penalty as they
-require additional lookups to be translated to the
-"'$$<project>~<changeNumber>$$'" identifier.
+Even though these identifiers will work in the majority of cases it is highly
+recommended to use "'$$<project>~<changeNumber>$$'" whenever possible.
+Since these identifiers require additional lookups from index and caches, to
+be translated to the "'$$<project>~<changeNumber>$$'" identifier, they
+may result in both false-positives and false-negatives.
+Furthermore the additional lookup mean that they come with a performance penalty.
* an ID of the change in the format "'$$<project>~<branch>~<Change-Id>$$'",
where for the branch the `refs/heads/` prefix can be omitted
