diff --git a/core/lib/Drupal/Core/Database/Connection.php b/core/lib/Drupal/Core/Database/Connection.php
index 9d13c3f781..22b5db983d 100644
--- a/core/lib/Drupal/Core/Database/Connection.php
+++ b/core/lib/Drupal/Core/Database/Connection.php
@@ -480,7 +480,7 @@ public function prefixTables($sql) {
    *   quoted.
    *
    * @internal
-   *   This method should normally be used only within database driver code.
+   *   This method should only be called by database API code.
    */
   public function quoteIdentifiers($sql) {
     return str_replace(['[', ']'], $this->identifierQuotes, $sql);
@@ -1082,22 +1082,22 @@ public function insert($table, array $options = []) {
   /**
    * Returns the ID of the last inserted row or sequence value.
    *
-   * This is a proxy to invoke lastInsertId() from the wrapped PDO connection.
-   * If a sequence name is not specified for the name parameter,
-   * \PDO::lastInsertId() returns a string representing the row ID of the last
-   * row that was inserted into the database.
-   * If a sequence name is specified for the name parameter,
-   * \PDO::lastInsertId() returns a string representing the last value retrieved
-   * from the specified sequence object.
+   * This method should normally be used only within database driver code.
+   *
+   * This is a proxy to invoke lastInsertId() from the wrapped connection.
+   * If a sequence name is not specified for the name parameter, this returns a
+   * string representing the row ID of the last row that was inserted into the
+   * database.
+   * If a sequence name is specified for the name parameter, this returns a
+   * string representing the last value retrieved from the specified sequence
+   * object.
    *
    * @param string|null $name
    *   (Optional) Name of the sequence object from which the ID should be
    *   returned.
    *
    * @return string|false
-   *   The value returned by the wrapped PDO connection.
-   *
-   * @internal
+   *   The value returned by the wrapped connection.
    *
    * @see \PDO::lastInsertId
    */