Update to Drupal 8.0.2. For more information, see https://www.drupal.org/drupal-8.0.2-release-notes

core/lib/Drupal/Core/Plugin/Context/ContextInterface.php

@@ -32,9 +32,9 @@ interface ContextInterface extends ComponentContextInterface, CacheableDependenc
   /**
    * Adds a dependency on an object: merges its cacheability metadata.
    *
-   * E.g. when a context depends on some configuration, an entity, or an access
-   * result, we must make sure their cacheability metadata is present on the
-   * response. This method makes doing that simple.
+   * For example, when a context depends on some configuration, an entity, or an
+   * access result, we must make sure their cacheability metadata is present on
+   * the response. This method makes doing that simple.
    *
    * @param \Drupal\Core\Cache\CacheableDependencyInterface|mixed $dependency
    *   The dependency. If the object implements CacheableDependencyInterface,

core/lib/Drupal/Core/Plugin/DefaultPluginManager.php

@@ -289,7 +289,7 @@ class DefaultPluginManager extends PluginManagerBase implements PluginManagerInt
    * Invokes the hook to alter the definitions if the alter hook is set.
    *
    * @param $definitions
-   *   The discovered plugin defintions.
+   *   The discovered plugin definitions.
    */
   protected function alterDefinitions(&$definitions) {
     if ($this->alterHook) {

core/lib/Drupal/Core/Plugin/Discovery/AnnotatedClassDiscovery.php

@@ -120,13 +120,13 @@ class AnnotatedClassDiscovery extends ComponentAnnotatedClassDiscovery {
     if ($this->namespaceSuffix) {
       foreach ($this->rootNamespacesIterator as $namespace => $dirs) {
         // Append the namespace suffix to the base namespace, to obtain the
-        // plugin namespace. E.g. 'Drupal\Views' may become
+        // plugin namespace; for example, 'Drupal\Views' may become
         // 'Drupal\Views\Plugin\Block'.
         $namespace .= $this->namespaceSuffix;
         foreach ((array) $dirs as $dir) {
           // Append the directory suffix to the PSR-4 base directory, to obtain
-          // the directory where plugins are found.
-          // E.g. DRUPAL_ROOT . '/core/modules/views/src' may become
+          // the directory where plugins are found. For example,
+          // DRUPAL_ROOT . '/core/modules/views/src' may become
           // DRUPAL_ROOT . '/core/modules/views/src/Plugin/Block'.
           $plugin_namespaces[$namespace][] = $dir . $this->directorySuffix;
         }

core/lib/Drupal/Core/Plugin/Discovery/YamlDiscovery.php

@@ -47,8 +47,8 @@ class YamlDiscovery implements DiscoveryInterface {
    * Construct a YamlDiscovery object.
    *
    * @param string $name
-   *   The file name suffix to use for discovery. E.g. 'test' will become
-   *   'MODULE.test.yml'.
+   *   The file name suffix to use for discovery; for example, 'test' will
+   *   become 'MODULE.test.yml'.
    * @param array $directories
    *   An array of directories to scan.
    */

core/lib/Drupal/Core/Plugin/Discovery/YamlDiscoveryDecorator.php

@@ -30,8 +30,8 @@ class YamlDiscoveryDecorator extends YamlDiscovery {
    * @param \Drupal\Component\Plugin\Discovery\DiscoveryInterface $decorated
    *   The discovery object that is being decorated.
    * @param string $name
-   *   The file name suffix to use for discovery. E.g. 'test' will become
-   *   'MODULE.test.yml'.
+   *   The file name suffix to use for discovery; for instance, 'test' will
+   *   become 'MODULE.test.yml'.
    * @param array $directories
    *   An array of directories to scan.
    */

core/lib/Drupal/Core/Plugin/PluginFormInterface.php

@@ -27,8 +27,7 @@ interface PluginFormInterface {
    * callback and build the rest of the form in the callback. By the time the
    * callback is executed, the element's #parents and #array_parents properties
    * will have been set by the form API. For more documentation on #parents and
-   * #array_parents, see
-   * https://api.drupal.org/api/drupal/developer!topics!forms_api_reference.html/8.
+   * #array_parents, see \Drupal\Core\Render\Element\FormElement.
    *
    * @param array $form
    *   An associative array containing the initial structure of the plugin form.