more doc

Author: fredzqm

packages/firebase/index.d.ts

@@ -5510,8 +5510,8 @@ declare namespace firebase.storage {
      * References to sub-folders. You can call list() on them to get its contents.
      * GCS's
      *
-     * Folder is implict using '/' as the delimiter.
-     * For example, if you have two objects '/a/b/1' and '/a/b/2', list('/a')
+     * Folders are implict based on '/' in the object paths.
+     * For example, if a bucket has two objects '/a/b/1' and '/a/b/2', list('/a')
      * will return '/a/b' as a prefix.
      */
     prefixes: Reference[];

packages/storage/src/implementation/list.ts

@@ -26,7 +26,8 @@ import { ListResult } from '../list';
 
 /**
  * Represents the simplified object metadata returned by List API.
- * Other fields are filtered because list does not grant permission to get metadata.
+ * Other fields are filtered because list in Firebase Rules does not grant
+ * the permission to read the metadata.
  */
 interface ListMetadataResponse {
   name: string;