chore(docs): fixes found from running the validator (#6669)

src/Acl.php

@@ -80,6 +80,8 @@ public function __construct(ConnectionInterface $connection, $type, array $ident
     }
 
     /**
+     * Delete access controls.
+     *
      * Delete access controls on a {@see Bucket} or
      * {@see StorageObject} for a specified entity.
      *
@@ -106,6 +108,8 @@ public function delete($entity, array $options = [])
     }
 
     /**
+     * Get access controls.
+     *
      * Get access controls on a {@see Bucket} or
      * {@see StorageObject}. By default this will return all available
      * access controls. You may optionally specify a single entity to return
@@ -141,6 +145,8 @@ public function get(array $options = [])
     }
 
     /**
+     * Add access controls.
+     *
      * Add access controls on a {@see Bucket} or
      * {@see StorageObject}.
      *
@@ -173,8 +179,9 @@ public function add($entity, $role, array $options = [])
     }
 
     /**
-     * Update access controls on a {@see Bucket} or
-     * {@see StorageObject}.
+     * Update access controls.
+     *
+     * Update access controls on a {@see Bucket} or {@see StorageObject}.
      *
      * Example:
      * ```

src/Bucket.php

@@ -566,7 +566,9 @@ public function getStreamableUploader($data, array $options = [])
 
     /**
      * Lazily instantiates an object. There are no network requests made at this
-     * point. To see the operations that can be performed on an object please
+     * point.
+     *
+     * To see the operations that can be performed on an object please
      * see {@see StorageObject}.
      *
      * Example:
@@ -787,7 +789,9 @@ public function createNotification($topic, array $options = [])
 
     /**
      * Lazily instantiates a notification. There are no network requests made at
-     * this point. To see the operations that can be performed on a notification
+     * this point.
+     *
+     * To see the operations that can be performed on a notification
      * please see {@see Notification}.
      *
      * Example:
@@ -1218,7 +1222,9 @@ public static function lifecycle(array $lifecycle = [])
 
     /**
      * Retrieves a lifecycle builder preconfigured with the lifecycle rules that
-     * already exists on the bucket. Use this if you want to make updates to an
+     * already exists on the bucket.
+     *
+     * Use this if you want to make updates to an
      * existing configuration without removing existing rules, as would be the
      * case when using {@see Bucket::lifecycle()}.
      *

src/ObjectIterator.php

@@ -20,6 +20,8 @@
 use Google\Cloud\Core\Iterator\ItemIteratorTrait;
 
 /**
+ * ObjectIterator
+ *
  * Iterates over a set of {@see StorageObject} items.
  */
 class ObjectIterator implements \Iterator

src/ObjectPageIterator.php

@@ -20,6 +20,8 @@
 use Google\Cloud\Core\Iterator\PageIteratorTrait;
 
 /**
+ * ObjectPageIterator
+ *
  * Iterates over a set of pages containing
  * {@see StorageObject} items.
  */

src/StorageClient.php

@@ -127,9 +127,10 @@ public function __construct(array $config = [])
     }
 
     /**
-     * Lazily instantiates a bucket. There are no network requests made at this
-     * point. To see the operations that can be performed on a bucket please
-     * see {@see Bucket}.
+     * Lazily instantiates a bucket.
+     *
+     * There are no network requests made at this point. To see the operations
+     * that can be performed on a bucket please see {@see Bucket}.
      *
      * If `$userProject` is set to true, the current project ID (used to
      * instantiate the client) will be billed for all requests. If