diff -u b/core/lib/Drupal/Core/Extension/module.api.php b/core/lib/Drupal/Core/Extension/module.api.php --- b/core/lib/Drupal/Core/Extension/module.api.php +++ b/core/lib/Drupal/Core/Extension/module.api.php @@ -20,7 +20,7 @@ * you can use the Update API to update the data. This API is described in brief * here; for more details, see https://www.drupal.org/node/2535316. If you are * updating your module for a major version of Drupal (for instance, Drupal 7 to - * Drupal 8), updates will not run and you'll need to use the + * Drupal 8), updates will not run and you will need to use the * @link migrate Migrate API @endlink instead. * * @section sec_when When to write update code @@ -44,7 +44,7 @@ * https://www.drupal.org/node/2535316 for details and examples. * * @section sec_test Testing update code - * Update code should be tested both manually and by writing an automatic test. + * Update code should be tested both manually and by writing an automated test. * Automated tests for update code extend * \Drupal\system\Tests\Update\UpdatePathTestBase -- see that class for details, * and find classes that extend it for examples. @@ -513,7 +513,7 @@ * not work as you expect. You cannot count on when update functions will be * run. * - * @section sec_bulk Multi-pass or bulk updates + * @section sec_bulk Batch updates * If running your update all at once could possibly cause PHP to time out, use * the $sandbox parameter to indicate that the Batch API should be used for your * update. In this case, your update function acts as an implementation of @@ -528,7 +528,7 @@ * how to use the Batch API. * * @param array $sandbox - * Stores information for multi-pass updates. See above for more information. + * Stores information for batch updates. See above for more information. * * @throws \Drupal\Core\Utility\UpdateException|PDOException * In case of error, update hooks should throw an instance of @@ -549,7 +549,7 @@ * @see update_get_update_list() */ function hook_update_N(&$sandbox) { - // For non-multipass updates, the signature can simply be: + // For non-batch updates, the signature can simply be: // function hook_update_N() { // If you are performing database updates, as in the