javadoc: recommend Storage.writer for large uploads

mziccard · mziccard · commit 82cd3ea7db5e · 2015-09-29T18:05:53.000+02:00
diff --git a/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Storage.java b/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Storage.java
@@ -494,15 +494,17 @@ public static Builder builder() {
   BucketInfo create(BucketInfo bucketInfo, BucketTargetOption... options);
 
   /**
-   * Create a new blob.
+   * Create a new blob. Direct upload is used to upload {@code content}. For large content,
+   * {@link #writer} is recommended as it uses resumable upload.
    *
    * @return a complete blob information.
    * @throws StorageException upon failure
    */
   BlobInfo create(BlobInfo blobInfo, byte[] content, BlobTargetOption... options);
 
   /**
-   * Create a new blob.
+   * Create a new blob. Direct upload is used to upload {@code content}. For large content,
+   * {@link #writer} is recommended as it uses resumable upload.
    *
    * @return a complete blob information.
    * @throws StorageException upon failure
