@@ -6,7 +6,8 @@ application that uses Java NIO without the need to recompile.
 
 Note that whenever possible, you instead want to recompile the app and use the normal
 dependency mechanism to add a dependency to google-cloud-nio. You can see examples of
-this in the [google-cloud-examples](../../../google-cloud-examples) project.
+this in the [google-cloud-examples](../../../google-cloud-examples) project,
+[under nio](../../../google-cloud-examples/src/main/java/com/google/cloud/examples/nio).
 
 To run this example:
 
 
@@ -57,7 +57,8 @@ Authentication
 --------------
 
 See the [Authentication](https://github.com/googleapis/google-cloud-java#authentication)
-section in the base directory's README.
+section in the base directory's README. This shows how to construct the `StorageOptions` object,
+which you can then pass to `CloudStorageFileSystem.forBucket`.
 
 About Google Cloud Storage
 --------------------------
 
@@ -140,7 +140,12 @@ protected Path computeNext() {
     }
   }
 
-  /** Sets options that are only used by the constructor. */
+  /**
+   * Sets options that are only used by the constructor.
+   *
+   * <p>Instead of calling this, when possible use CloudStorageFileSystem.forBucket and pass
+   * StorageOptions as an argument.
+   */
   @VisibleForTesting
   public static void setStorageOptions(@Nullable StorageOptions newStorageOptions) {
     futureStorageOptions = newStorageOptions;
Original file line number	Diff line number	Diff line change
`@@ -140,7 +140,12 @@ protected Path computeNext() {`
`140`	`140`	`}`
`141`	`141`	`}`
`142`	`142`
`143`		`- /** Sets options that are only used by the constructor. */`
	`143`	`+ /**`
	`144`	`+ * Sets options that are only used by the constructor.`
	`145`	`+ *`
	`146`	`+ * <p>Instead of calling this, when possible use CloudStorageFileSystem.forBucket and pass`
	`147`	`+ * StorageOptions as an argument.`
	`148`	`+ */`
`144`	`149`	`@VisibleForTesting`
`145`	`150`	`public static void setStorageOptions(@Nullable StorageOptions newStorageOptions) {`
`146`	`151`	`futureStorageOptions = newStorageOptions;`