@@ -300,7 +300,7 @@ public static class IsLiveDeleteRule extends DeleteRule {
300300 * Creates an {@code IsLiveDeleteRule} object.
301301 *
302302 * @param isLive if set to {@code true} live blobs meet the delete condition. If set to
303- * {@code false} delete condition is met by archived objects .
303+ * {@code false} delete condition is met by archived blobs .
304304 */
305305 public IsLiveDeleteRule (boolean isLive ) {
306306 super (Type .IS_LIVE );
@@ -362,31 +362,33 @@ Builder selfLink(String selfLink) {
362362 }
363363
364364 /**
365- * Sets whether blob versioning should be enabled or not for the bucket.
365+ * Sets whether versioning should be enabled for this bucket. When set to true, versioning is
366+ * fully enabled.
366367 */
367368 public Builder versioningEnabled (Boolean enable ) {
368369 this .versioningEnabled = firstNonNull (enable , Data .<Boolean >nullOf (Boolean .class ));
369370 return this ;
370371 }
371372
372373 /**
373- * Sets the bucket's website index page.
374+ * Sets the bucket's website index page. Behaves as the bucket's directory index where missing
375+ * blobs are treated as potential directories.
374376 */
375377 public Builder indexPage (String indexPage ) {
376378 this .indexPage = indexPage ;
377379 return this ;
378380 }
379381
380382 /**
381- * Sets the bucket's website page to return when a resource is not found.
383+ * Sets the custom object to return when a requested resource is not found.
382384 */
383385 public Builder notFoundPage (String notFoundPage ) {
384386 this .notFoundPage = notFoundPage ;
385387 return this ;
386388 }
387389
388390 /**
389- * Sets bucket's delete rules.
391+ * Sets the bucket's lifecycle configuration as a number of delete rules.
390392 *
391393 * @see <a href="https://cloud.google.com/storage/docs/lifecycle">Lifecycle Management</a>
392394 */
@@ -396,18 +398,18 @@ public Builder deleteRules(Iterable<? extends DeleteRule> rules) {
396398 }
397399
398400 /**
399- * Sets the bucket's storage class. A list of supported values is available
400- * <a href="https://cloud.google.com/storage/docs/json_api/v1/buckets#resource">here</a>.
401- *
402- * @see <a href="https://cloud.google.com/storage/docs/storage-classes">Storage Classes</a>
401+ * Sets the bucket's storage class. This defines how blobs in the bucket are stored and
402+ * determines the SLA and the cost of storage. A list of supported values is available
403+ * <a href="https://cloud.google.com/storage/docs/storage-classes">here</a>.
403404 */
404405 public Builder storageClass (String storageClass ) {
405406 this .storageClass = storageClass ;
406407 return this ;
407408 }
408409
409410 /**
410- * Sets the bucket's location. A list of supported values is available
411+ * Sets the bucket's location. Data for blobs in the bucket resides in physical storage within
412+ * this region. A list of supported values is available
411413 * <a href="https://cloud.google.com/storage/docs/bucket-locations">here</a>.
412414 */
413415 public Builder location (String location ) {
@@ -507,7 +509,7 @@ public String name() {
507509 }
508510
509511 /**
510- * Returns the bucket's owner.
512+ * Returns the bucket's owner. This is always the project team's owner group.
511513 */
512514 public Entity owner () {
513515 return owner ;
@@ -521,35 +523,40 @@ public String selfLink() {
521523 }
522524
523525 /**
524- * Returns {@code true} if blob versioning is enabled for this bucket, {@code false} otherwise.
526+ * Returns {@code true} if versioning is fully enabled for this bucket, {@code false} otherwise.
525527 */
526528 public Boolean versioningEnabled () {
527529 return Data .isNull (versioningEnabled ) ? null : versioningEnabled ;
528530 }
529531
530532 /**
531- * Returns bucket's website index page.
533+ * Returns bucket's website index page. Behaves as the bucket's directory index where missing
534+ * blobs are treated as potential directories.
532535 */
533536 public String indexPage () {
534537 return indexPage ;
535538 }
536539
537540 /**
538- * Returns bucket's website not found page, used we a resource could not be found.
541+ * Returns the custom object to return when a requested resource is not found.
539542 */
540543 public String notFoundPage () {
541544 return notFoundPage ;
542545 }
543546
544547 /**
545- * Returns bucket's delete rules.
548+ * Returns bucket's lifecycle configuration as a number of delete rules.
549+ *
550+ * @see <a href="https://cloud.google.com/storage/docs/lifecycle">Lifecycle Management</a>
546551 */
547552 public List <? extends DeleteRule > deleteRules () {
548553 return deleteRules ;
549554 }
550555
551556 /**
552- * Returns bucket resource's entity tag.
557+ * Returns HTTP 1.1 Entity tag for the bucket.
558+ *
559+ * @see <a href="http://tools.ietf.org/html/rfc2616#section-3.11">Entity Tags</a>
553560 */
554561 public String etag () {
555562 return etag ;
@@ -570,7 +577,8 @@ public Long metageneration() {
570577 }
571578
572579 /**
573- * Returns the bucket's location.
580+ * Returns the bucket's location. Data for blobs in the bucket resides in physical storage within
581+ * this region.
574582 *
575583 * @see <a href="https://cloud.google.com/storage/docs/bucket-locations">Bucket Locations</a>
576584 */
@@ -579,7 +587,8 @@ public String location() {
579587 }
580588
581589 /**
582- * Returns the bucket's storage class.
590+ * Returns the bucket's storage class. This defines how blobs in the bucket are stored and
591+ * determines the SLA and the cost of storage.
583592 *
584593 * @see <a href="https://cloud.google.com/storage/docs/storage-classes">Storage Classes</a>
585594 */
@@ -589,6 +598,9 @@ public String storageClass() {
589598
590599 /**
591600 * Returns the bucket's Cross-Origin Resource Sharing (CORS) configuration.
601+ *
602+ * @see <a href="https://cloud.google.com/storage/docs/cross-origin">
603+ * Cross-Origin Resource Sharing (CORS)</a>
592604 */
593605 public List <Cors > cors () {
594606 return cors ;
0 commit comments