Issue #2042239 by tbradbury, pkiraly, lucaslg, pjonckiere, oriol_e9g, ivanchaer, jhodgdon, chx, cilefen, David_Rothstein: DeleteQuery::execute (Delete::execute() in D8) return value documentation is unusable

core/lib/Drupal/Core/Database/Query/Delete.php

@@ -47,8 +47,8 @@ class Delete extends Query implements ConditionInterface {
   /**
    * Executes the DELETE query.
    *
-   * @return
-   *   The return value is dependent on the database connection.
+   * @return int
+   *   The number of rows affected by the delete query.
    */
   public function execute() {
     $values = array();