diff --git a/core/modules/search/src/SearchQuery.php b/core/modules/search/src/SearchQuery.php
index c1ecb48..943df2c 100644
--- a/core/modules/search/src/SearchQuery.php
+++ b/core/modules/search/src/SearchQuery.php
@@ -486,10 +486,7 @@ public function preExecute(SelectInterface $query = NULL) {
    * used. However, if at least one call to addScore() has taken place, the
    * keyword relevance score is not automatically added.
    *
-   * Also note that if you call orderBy() directly on the query, search scores
-   * will not automatically be used to order search results. Your orderBy()
-   * expression can reference 'calculated_score', which will be the total
-   * calculated score value.
+   * Note that you cannot call orderBy() on the query: this will not work.
    *
    * @param string $score
    *   The score expression, which should evaluate to a number between 0 and 1.
