Documentation for Blob.update() and Storage.update() methods is confusing/incorrect. #252
Labels
api: storage
Issues related to the googleapis/java-storage API.
documentation
Improvements or additions to documentation
priority: p2
Moderately-important priority. Fix may not be included in next release.
Documentation for Blob.update(Options...) doesn't include example of usage, the provided examples demonstrate how to use
Storage.update(blobInfo)
. The doc also mentions non existing parameterblobInfo
:Original metadata are merged with metadata in the provided blobInfo.
Taking into account the fact that
Objects of this class are immutable.
this method seems useless.The documentation should be updated to clarify usage.
Documentation for Storage.update() methods is better but still confusing. The important aspects are not covered:
metadata
could be read asblob's information
or asblob's user provided metadata
Documentation should be aligned with the new Blob/BlobInfo API Doc introduced by #176
The text was updated successfully, but these errors were encountered: