Docs update for Extensions and putFile (#10248)

Author: paulb777

FirebaseStorage/Sources/AsyncAwait.swift

@@ -57,6 +57,7 @@ import Foundation
     }
 
     /// Asynchronously uploads a file to the currently specified StorageReference.
+    /// `putDataAsync` should be used instead of `putFileAsync` in Extensions.
     ///
     /// - Parameters:
     ///   - url: A URL representing the system file path of the object to be uploaded.

FirebaseStorage/Sources/StorageReference.swift

@@ -174,6 +174,7 @@ import Foundation
 
   /**
    * Asynchronously uploads a file to the currently specified `StorageReference`.
+   * `putData` should be used instead of `putFile` in Extensions.
    * - Parameters:
    *   - fileURL: A URL representing the system file path of the object to be uploaded.
    *   - metadata: `StorageMetadata` containing additional information (MIME type, etc.)
@@ -188,6 +189,7 @@ import Foundation
   /**
    * Asynchronously uploads a file to the currently specified `StorageReference`,
    * without additional metadata.
+   * `putData` should be used instead of `putFile` in Extensions.
    * @param fileURL A URL representing the system file path of the object to be uploaded.
    * @return An instance of StorageUploadTask, which can be used to monitor or manage the upload.
    */
@@ -197,6 +199,7 @@ import Foundation
 
   /**
    * Asynchronously uploads a file to the currently specified `StorageReference`.
+   * `putData` should be used instead of `putFile` in Extensions.
    * - Parameters:
    *   - fileURL: A URL representing the system file path of the object to be uploaded.
    *   - metadata: `StorageMetadata` containing additional information (MIME type, etc.)