Storage: Blob.delete returns self.bucket.delete_blob but delete_blob returns nothing

[sheiun]

Description

In this function docs returns part says returns The blob that was just deleted. but actually self.bucket.delete_blob didn't return anything and rtype also not Blob but None.

I'm not sure the fault is that Blob.delete return unnecessary or Bucket.delete_blob didn't return after blob api_request.

Blob

https://github.com/googleapis/google-cloud-python/blob/master/storage/google/cloud/storage/blob.py#L548

 def delete(self, client=None):
 """Deletes a blob from Cloud Storage.
 If :attr:`user_project` is set on the bucket, bills the API request
 to that project.
 :type client: :class:`~google.cloud.storage.client.Client` or
 ``NoneType``
 :param client: Optional. The client to use. If not passed, falls back
 to the ``client`` stored on the blob's bucket.
 :rtype: :class:`Blob`
 :returns: The blob that was just deleted.
 :raises: :class:`google.cloud.exceptions.NotFound`
 (propagated from
 :meth:`google.cloud.storage.bucket.Bucket.delete_blob`).
 """
 return self.bucket.delete_blob(
 self.name, client=client, generation=self.generation
 )

Bucket

https://github.com/googleapis/google-cloud-python/blob/master/storage/google/cloud/storage/bucket.py#L1055

 def delete_blob(self, blob_name, client=None, generation=None):
 """Deletes a blob from the current bucket.
 If the blob isn't found (backend 404), raises a
 :class:`google.cloud.exceptions.NotFound`.
 For example:
 .. literalinclude:: snippets.py
 :start-after: [START delete_blob]
 :end-before: [END delete_blob]
 If :attr:`user_project` is set, bills the API request to that project.
 :type blob_name: str
 :param blob_name: A blob name to delete.
 :type client: :class:`~google.cloud.storage.client.Client` or
 ``NoneType``
 :param client: Optional. The client to use. If not passed, falls back
 to the ``client`` stored on the current bucket.
 :type generation: long
 :param generation: Optional. If present, permanently deletes a specific
 revision of this object.
 :raises: :class:`google.cloud.exceptions.NotFound` (to suppress
 the exception, call ``delete_blobs``, passing a no-op
 ``on_error`` callback, e.g.:
 .. literalinclude:: snippets.py
 :start-after: [START delete_blobs]
 :end-before: [END delete_blobs]
 """
 client = self._require_client(client)
 blob = Blob(blob_name, bucket=self, generation=generation)

 # We intentionally pass `_target_object=None` since a DELETE
 # request has no response value (whether in a standard request or
 # in a batch request).
 client._connection.api_request(
 method="DELETE",
 path=blob.path,
 query_params=blob._query_params,
 _target_object=None,
 )