Review and Enhance JavaDocs in Storage Blobs

[jianghaolu]

No description provided.

[vhvb1989]

hey @jianghaolu , is this the same as #5187?
Can we close this one as duplicated of that one? or is there something else you would like for this one to be implemented?

[rickle-msft]

The Javadoc comments for Storage Blobs do not seem to correspond with the SDK. For example,
in BlobContainerAsynClient getBlobAsyncClient(String) it says, but it should refer to the builder.

/**
 * Creates a new BlobAsyncClient object by concatenating blobName to the end of ContainerAsyncClient's URL. The new
 * BlobAsyncClient uses the same request policy pipeline as the ContainerAsyncClient. To change the pipeline, create
 * the BlobAsyncClient and then call its WithPipeline method passing in the desired pipeline object. Or, call this
 * package's getBlobAsyncClient instead of calling this object's getBlobAsyncClient method.
 *
 * <p><strong>Code Samples</strong></p>
 *
 * {@codesnippet com.azure.storage.blob.BlobContainerAsyncClient.getBlobAsyncClient#String}
 *
 * @param blobName A {@code String} representing the name of the blob.
 * @return A new {@link BlobAsyncClient} object which references the blob with the specified name in this container.
 */

[alzimmermsft]

Closing as Storage Blobs documentation has been reviewed and enhanced with code samples and further details.