diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryAsyncClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryAsyncClient.java
index 2c88dbf1bbb3..e5a044464b8d 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryAsyncClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryAsyncClient.java
@@ -141,6 +141,9 @@ public DirectoryAsyncClient getSubDirectoryClient(String subDirectoryName) {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.create}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory name is an invalid resource name.
      */
@@ -157,6 +160,9 @@ public Mono<Response<DirectoryInfo>> create() {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.create#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the directory
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory name is an invalid resource name.
@@ -175,6 +181,9 @@ public Mono<Response<DirectoryInfo>> create(Map<String, String> metadata) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -193,6 +202,9 @@ public Mono<VoidResponse> delete() {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-directory-properties">Azure Docs</a>.</p>
+     *
      * @return Storage directory properties
      */
     public Mono<Response<DirectoryProperties>> getProperties() {
@@ -215,6 +227,9 @@ public Mono<Response<DirectoryProperties>> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.setMetadata#map.clearMetadata}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-directory-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to set on the directory, if null is passed the metadata for the directory is cleared
      * @return information about the directory
      * @throws StorageErrorException If the directory doesn't exist or the metadata contains invalid keys
@@ -233,6 +248,9 @@ public Mono<Response<DirectorySetMetadataInfo>> setMetadata(Map<String, String>
      *
      * {@codesnippet com.azure.storage.file.directoryClient.listFilesAndDirectories}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files">Azure Docs</a>.</p>
+     *
      * @return {@link FileRef File info} in the storage directory
      */
     public Flux<FileRef> listFilesAndDirectories() {
@@ -248,6 +266,9 @@ public Flux<FileRef> listFilesAndDirectories() {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.listFilesAndDirectories#string-integer}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files">Azure Docs</a>.</p>
+     *
      * @param prefix Optional prefix which filters the results to return only files and directories whose name begins with.
      * @param maxResults Optional maximum number of files and/or directories to return per page.
      *                   If the request does not specify maxresults or specifies a value greater than 5,000, the server will return up to 5,000 items.
@@ -267,6 +288,9 @@ public Flux<FileRef> listFilesAndDirectories(String prefix, Integer maxResults)
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.getHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @param maxResult Optional maximum number of results will return per page
      * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its subdirectories and their files.
      * @return {@link HandleItem handles} in the directory that satisfy the requirements
@@ -287,6 +311,9 @@ public Flux<HandleItem> getHandles(Integer maxResult, boolean recursive) {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.forceCloseHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles">Azure Docs</a>.</p>
+     *
      * @param handleId Specifies the handle ID to be closed. Use an asterisk ('*') as a wildcard string to specify all handles.
      * @param recursive A boolean value that specifies if the operation should also apply to the files and subdirectories of the directory specified in the URI.
      * @return The counts of number of handles closed
@@ -305,6 +332,9 @@ public Flux<Integer> forceCloseHandles(String handleId, boolean recursive) {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.createSubDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @return A response containing the subdirectory client and the status of creating the directory.
      * @throws StorageErrorException If the subdirectory has already existed, the parent directory does not exist or directory is an invalid resource name.
@@ -322,6 +352,9 @@ public Mono<Response<DirectoryAsyncClient>> createSubDirectory(String subDirecto
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createSubDirectory#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @param metadata Optional metadata to associate with the subdirectory
      * @return A response containing the subdirectory client and the status of creating the directory.
@@ -342,6 +375,9 @@ public Mono<Response<DirectoryAsyncClient>> createSubDirectory(String subDirecto
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.deleteSubDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the subdirectory doesn't exist, the parent directory does not exist or subdirectory name is an invalid resource name.
@@ -360,6 +396,9 @@ public Mono<VoidResponse> deleteSubDirectory(String subDirectoryName) {
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.createFile#string-long}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @param maxSize Size of the file
      * @return A response containing the FileAsyncClient and the status of creating the directory.
@@ -378,6 +417,9 @@ public Mono<Response<FileAsyncClient>> createFile(String fileName, long maxSize)
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.createFile#string-long-fileHTTPHeaders-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @param maxSize Max size of the file
      * @param httpHeaders the Http headers set to the file
@@ -399,6 +441,9 @@ public Mono<Response<FileAsyncClient>> createFile(String fileName, long maxSize,
      *
      * {@codesnippet com.azure.storage.file.directoryAsyncClient.deleteFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the directory doesn't exist or the file doesn't exist or file name is an invalid resource name.
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryClient.java
index 44c84a0dade2..7de1792d0c35 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/DirectoryClient.java
@@ -91,6 +91,9 @@ public DirectoryClient getSubDirectoryClient(String subDirectoryName) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createDirectory}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory name is an invalid resource name.
      */
@@ -107,6 +110,9 @@ public Response<DirectoryInfo> create() {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.create#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the directory.
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory name is an invalid resource name.
@@ -124,6 +130,9 @@ public Response<DirectoryInfo> create(Map<String, String> metadata) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -141,6 +150,9 @@ public VoidResponse delete() {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-directory-properties">Azure Docs</a>.</p>
+     *
      * @return Storage directory properties
      */
     public Response<DirectoryProperties> getProperties() {
@@ -162,6 +174,9 @@ public Response<DirectoryProperties> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.setMetadata#map.clearMetadata}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-directory-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to set on the directory, if null is passed the metadata for the directory is cleared
      * @return information about the directory
      * @throws StorageErrorException If the directory doesn't exist or the metadata contains invalid keys
@@ -179,6 +194,9 @@ public Response<DirectorySetMetadataInfo> setMetadata(Map<String, String> metada
      *
      * {@codesnippet com.azure.storage.file.directoryClient.listFilesAndDirectories}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files">Azure Docs</a>.</p>
+     *
      * @return {@link FileRef File info} in the storage directory
      */
     public Iterable<FileRef> listFilesAndDirectories() {
@@ -194,6 +212,9 @@ public Iterable<FileRef> listFilesAndDirectories() {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.listFilesAndDirectories#string-integer}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files">Azure Docs</a>.</p>
+     *
      * @param prefix Optional prefix which filters the results to return only files and directories whose name begins with.
      * @param maxResults Optional maximum number of files and/or directories to return per page.
      *                   If the request does not specify maxresults or specifies a value greater than 5,000, the server will return up to 5,000 items.
@@ -212,6 +233,9 @@ public Iterable<FileRef> listFilesAndDirectories(String prefix, Integer maxResul
      *
      * {@codesnippet com.azure.storage.file.directoryClient.getHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @param maxResult Optional maximum number of results will return per page
      * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its subdirectories and their files.
      * @return {@link HandleItem handles} in the directory that satisfy the requirements
@@ -231,6 +255,9 @@ public Iterable<HandleItem> getHandles(Integer maxResult, boolean recursive) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.forceCloseHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles">Azure Docs</a>.</p>
+     *
      * @param handleId Specifies the handle ID to be closed. Use an asterisk ('*') as a wildcard string to specify all handles.
      * @param recursive A boolean value that specifies if the operation should also apply to the files and subdirectories of the directory specified in the URI.
      * @return The counts of number of handles closed.
@@ -248,6 +275,9 @@ public Iterable<Integer> forceCloseHandles(String handleId, boolean recursive) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createSubDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @return A response containing the subdirectory client and the status of creating the directory.
      * @throws StorageErrorException If the subdirectory has already existed, the parent directory does not exist or directory is an invalid resource name.
@@ -265,6 +295,9 @@ public Response<DirectoryClient> createSubDirectory(String subDirectoryName) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createSubDirectory#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @param metadata Optional metadata to associate with the subdirectory
      * @return A response containing the subdirectory client and the status of creating the directory.
@@ -284,6 +317,9 @@ public Response<DirectoryClient> createSubDirectory(String subDirectoryName, Map
      *
      * {@codesnippet com.azure.storage.file.directoryClient.deleteSubDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @param subDirectoryName Name of the subdirectory
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the subdirectory doesn't exist, the parent directory does not exist or subdirectory name is an invalid resource name.
@@ -301,6 +337,9 @@ public VoidResponse deleteSubDirectory(String subDirectoryName) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createFile#string-long}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @param maxSize Size of the file
      * @return A response containing the FileClient and the status of creating the directory.
@@ -319,6 +358,9 @@ public Response<FileClient> createFile(String fileName, long maxSize) {
      *
      * {@codesnippet com.azure.storage.file.directoryClient.createFile#string-long-fileHTTPHeaders-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @param maxSize Max size of the file
      * @param httpHeaders the Http headers set to the file
@@ -340,6 +382,9 @@ public Response<FileClient> createFile(String fileName, long maxSize, FileHTTPHe
      *
      * {@codesnippet com.azure.storage.file.directoryClient.deleteFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2">Azure Docs</a>.</p>
+     *
      * @param fileName Name of the file
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the directory doesn't exist or the file doesn't exist or file name is an invalid resource name.
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileAsyncClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileAsyncClient.java
index 4105edd38b20..ce3b9b561530 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileAsyncClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileAsyncClient.java
@@ -140,6 +140,9 @@ public URL getFileUrl() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.create}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param maxSize The maximum size in bytes for the file, up to 1 TiB.
      * @return A response containing the file info and the status of creating the file.
      * @throws StorageErrorException If the file has already existed, the parent directory does not exist or fileName is an invalid resource name.
@@ -157,10 +160,13 @@ public Mono<Response<FileInfo>> create(long maxSize) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.create#long-filehttpheaders-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param maxSize The maximum size in bytes for the file, up to 1 TiB.
      * @param httpHeaders Additional parameters for the operation.
      * @param metadata Optional name-value pairs associated with the file as metadata. Metadata names must adhere to the naming rules.
-     *                           @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
+     * @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory is an invalid resource name.
      */
@@ -178,9 +184,12 @@ public Mono<Response<FileInfo>> create(long maxSize, FileHTTPHeaders httpHeaders
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.startCopy#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/copy-file">Azure Docs</a>.</p>
+     *
      * @param sourceUrl Specifies the URL of the source file or blob, up to 2 KB in length.
      * @param metadata Optional name-value pairs associated with the file as metadata. Metadata names must adhere to the naming rules.
-     *      *                           @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
+     * @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
      * @return A response containing the file copy info and the status of copying the file.
      */
     public Mono<Response<FileCopyInfo>> startCopy(String sourceUrl, Map<String, String> metadata) {
@@ -197,6 +206,9 @@ public Mono<Response<FileCopyInfo>> startCopy(String sourceUrl, Map<String, Stri
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.abortCopy#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-file">Azure Docs</a>.</p>
+     *
      * @param copyId Specifies the copy id which has copying pending status associate with it.
      * @return A response containing the status of aborting copy the file.
      */
@@ -214,6 +226,9 @@ public Mono<VoidResponse> abortCopy(String copyId) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.downloadToFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param downloadFilePath The path where store the downloaded file
      * @return An empty response.
      */
@@ -230,6 +245,9 @@ public Mono<Void> downloadToFile(String downloadFilePath) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.downloadToFile#string-filerange}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param downloadFilePath The path where store the downloaded file
      * @param range Optional byte range which returns file data only from the specified range.
      * @return An empty response.
@@ -297,6 +315,9 @@ private Flux<FileRange> sliceFileRange(FileRange fileRange) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.downloadWithProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      */
     public Mono<Response<FileDownloadInfo>> downloadWithProperties() {
@@ -312,6 +333,9 @@ public Mono<Response<FileDownloadInfo>> downloadWithProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.downloadWithProperties#filerange-boolean}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param range Optional byte range which returns file data only from the specified range.
      * @param rangeGetContentMD5 Optional boolean which the service returns the MD5 hash for the range when it sets to true, as long as the range is less than or equal to 4 MB in size.
      * @return A response that only contains headers and response status code
@@ -331,6 +355,9 @@ public Mono<Response<FileDownloadInfo>> downloadWithProperties(FileRange range,
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the directory doesn't exist or the file doesn't exist.
      */
@@ -349,6 +376,9 @@ public Mono<VoidResponse> delete() {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-properties">Azure Docs</a>.</p>
+     *
      * @return Storage file properties
      */
     public Mono<Response<FileProperties>> getProperties() {
@@ -371,6 +401,9 @@ public Mono<Response<FileProperties>> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.setHttpHeaders#long-filehttpheaders.clearHttpHeaders}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties">Azure Docs</a>.</p>
+     *
      * @param newFileSize New file size of the file
      * @param httpHeaders Resizes a file to the specified size. If the specified byte value is less than the current size of the file, then all ranges above the specified byte value are cleared.
      * @return Response of the information about the file
@@ -396,13 +429,16 @@ public Mono<Response<FileInfo>> setHttpHeaders(long newFileSize, FileHTTPHeaders
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.setMetadata#map.clearMetadata}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Options.Metadata to set on the file, if null is passed the metadata for the file is cleared
      * @return information about the file
      * @throws StorageErrorException If the file doesn't exist or the metadata contains invalid keys
      */
     public Mono<Response<FileMetadataInfo>> setMetadata(Map<String, String> metadata) {
         return azureFileStorageClient.files().setMetadataWithRestResponseAsync(shareName, filePath, null, metadata, Context.NONE)
-                    .map(this::setMeatadataResponse);
+                    .map(this::setMetadataResponse);
     }
 
     /**
@@ -414,6 +450,9 @@ public Mono<Response<FileMetadataInfo>> setMetadata(Map<String, String> metadata
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.upload#flux-long}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs</a>.</p>
+     *
      * @param data The data which will upload to the storage file.
      * @param length Specifies the number of bytes being transmitted in the request body. When the FileRangeWriteType is set to clear, the value of this header must be set to zero..
      * @return A response that only contains headers and response status code
@@ -434,6 +473,9 @@ public Mono<Response<FileUploadInfo>> upload(Flux<ByteBuf> data, long length) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.upload#bytebuf-long-int-filerangewritetype}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs</a>.</p>
+     *
      * @param data The data which will upload to the storage file.
      * @param offset Optional starting point of the upload range. It will start from the beginning if it is {@code null}
      * @param length Specifies the number of bytes being transmitted in the request body. When the FileRangeWriteType is set to clear, the value of this header must be set to zero.
@@ -460,6 +502,11 @@ public Mono<Response<FileUploadInfo>> upload(Flux<ByteBuf> data, long length, lo
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.uploadFromFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs Create File</a>
+     * and
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs Upload</a>.</p>
+     *
      * @param uploadFilePath The path where store the source file to upload
      * @return An empty response.
      */
@@ -476,6 +523,11 @@ public Mono<Void> uploadFromFile(String uploadFilePath) {
      *
      * (@codesnippet com.azure.storage.file.fileAsyncClient.uploadFromFile#string-filerangewritetype}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs Create File</a>
+     * and
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs Upload</a>.</p>
+     *
      * @param uploadFilePath The path where store the source file to upload
      * @param type You may specify one of the following options:
      * <ul>
@@ -521,6 +573,9 @@ private List<FileRange> sliceFile(String path) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.listRanges}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-ranges">Azure Docs</a>.</p>
+     *
      * @return {@link FileRange ranges} in the files.
      */
     public Flux<FileRange> listRanges() {
@@ -537,6 +592,9 @@ public Flux<FileRange> listRanges() {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.listRanges#filerange}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-ranges">Azure Docs</a>.</p>
+     *
      * @param range Optional byte range which returns file data only from the specified range.
      * @return {@link FileRange ranges} in the files that satisfy the requirements
      */
@@ -555,6 +613,9 @@ public Flux<FileRange> listRanges(FileRange range) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.listHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @return {@link HandleItem handles} in the files that satisfy the requirements
      */
     public Flux<HandleItem> listHandles() {
@@ -570,6 +631,9 @@ public Flux<HandleItem> listHandles() {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.listHandles#integer}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @param maxResults Optional maximum number of results will return per page
      * @return {@link HandleItem handles} in the file that satisfy the requirements
      */
@@ -589,6 +653,9 @@ public Flux<HandleItem> listHandles(Integer maxResults) {
      *
      * {@codesnippet com.azure.storage.file.fileAsyncClient.forceCloseHandles#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles">Azure Docs</a>.</p>
+     *
      * @param handleId Specifies the handle ID to be closed. Use an asterisk ('*') as a wildcard string to specify all handles.
      * @return The counts of number of handles closed
      */
@@ -717,7 +784,7 @@ private Response<FileUploadInfo> uploadResponse(final FilesUploadRangeResponse r
         return new SimpleResponse<>(response, fileUploadInfo);
     }
 
-    private Response<FileMetadataInfo> setMeatadataResponse(final FilesSetMetadataResponse response) {
+    private Response<FileMetadataInfo> setMetadataResponse(final FilesSetMetadataResponse response) {
         String eTag = response.deserializedHeaders().eTag();
         boolean isServerEncrypted = response.deserializedHeaders().isServerEncrypted();
         FileMetadataInfo fileMetadataInfo = new FileMetadataInfo(eTag, isServerEncrypted);
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileClient.java
index 4736673bee43..b8de3708e898 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileClient.java
@@ -68,6 +68,9 @@ public URL getFileUrl() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.create}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param maxSize The maximum size in bytes for the file, up to 1 TiB.
      * @return A response containing the file info and the status of creating the file.
      * @throws StorageErrorException If the file has already existed, the parent directory does not exist or fileName is an invalid resource name.
@@ -85,10 +88,13 @@ public Response<FileInfo> create(long maxSize) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.create#long-filehttpheaders-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs</a>.</p>
+     *
      * @param maxSize The maximum size in bytes for the file, up to 1 TiB.
      * @param httpHeaders Additional parameters for the operation.
      * @param metadata Optional name-value pairs associated with the file as metadata. Metadata names must adhere to the naming rules.
-     *                           @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
+     * @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
      * @return A response containing the directory info and the status of creating the directory.
      * @throws StorageErrorException If the directory has already existed, the parent directory does not exist or directory is an invalid resource name.
      */
@@ -105,6 +111,9 @@ public Response<FileInfo> create(long maxSize, FileHTTPHeaders httpHeaders, Map<
      *
      * {@codesnippet com.azure.storage.file.fileClient.startCopy#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/copy-file">Azure Docs</a>.</p>
+     *
      * @param sourceUrl Specifies the URL of the source file or blob, up to 2 KB in length.
      * @param metadata Optional name-value pairs associated with the file as metadata. Metadata names must adhere to the naming rules.
      * @see <a href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/">C# identifiers</a>
@@ -123,6 +132,9 @@ public Response<FileCopyInfo> startCopy(String sourceUrl, Map<String, String> me
      *
      * {@codesnippet com.azure.storage.file.fileClient.abortCopy#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-file">Azure Docs</a>.</p>
+     *
      * @param copyId Specifies the copy id which has copying pending status associate with it.
      * @return A response containing the status of aborting copy the file.
      */
@@ -139,6 +151,9 @@ public VoidResponse abortCopy(String copyId) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.downloadToFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param downloadFilePath The path where store the downloaded file
      */
     public void downloadToFile(String downloadFilePath) {
@@ -154,6 +169,9 @@ public void downloadToFile(String downloadFilePath) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.downloadToFile#string-filerange}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param downloadFilePath The path where store the downloaded file
      * @param range Optional byte range which returns file data only from the specified range.
      */
@@ -170,6 +188,9 @@ public void downloadToFile(String downloadFilePath, FileRange range) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.downloadWithProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      */
     public Response<FileDownloadInfo> downloadWithProperties() {
@@ -185,6 +206,9 @@ public Response<FileDownloadInfo> downloadWithProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.downloadWithProperties#filerange-boolean}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file">Azure Docs</a>.</p>
+     *
      * @param range Optional byte range which returns file data only from the specified range.
      * @param rangeGetContentMD5 Optional boolean which the service returns the MD5 hash for the range when it sets to true, as long as the range is less than or equal to 4 MB in size.
      * @return A response that only contains headers and response status code
@@ -202,6 +226,9 @@ public Response<FileDownloadInfo> downloadWithProperties(FileRange range, Boolea
      *
      * {@codesnippet com.azure.storage.file.fileClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the directory doesn't exist or the file doesn't exist.
      */
@@ -219,6 +246,9 @@ public VoidResponse delete() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-properties">Azure Docs</a>.</p>
+     *
      * @return Storage file properties
      */
     public Response<FileProperties> getProperties() {
@@ -240,6 +270,9 @@ public Response<FileProperties> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.setHttpHeaders#long-filehttpheaders.clearHttpHeaders}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties">Azure Docs</a>.</p>
+     *
      * @param newFileSize New file size of the file
      * @param httpHeaders Resizes a file to the specified size. If the specified byte value is less than the current size of the file, then all ranges above the specified byte value are cleared.
      * @return Response of the information about the file
@@ -264,6 +297,9 @@ public Response<FileInfo> setHttpHeaders(long newFileSize, FileHTTPHeaders httpH
      *
      * {@codesnippet com.azure.storage.file.fileClient.setMetadata#map.clearMetadata}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Options.Metadata to set on the file, if null is passed the metadata for the file is cleared
      * @return information about the file
      * @throws StorageErrorException If the file doesn't exist or the metadata contains invalid keys
@@ -281,6 +317,9 @@ public Response<FileMetadataInfo> setMetadata(Map<String, String> metadata) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.upload#flux-long}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs</a>.</p>
+     *
      * @param data The data which will upload to the storage file.
      * @param length Specifies the number of bytes being transmitted in the request body. When the FileRangeWriteType is set to clear, the value of this header must be set to zero..
      * @return A response that only contains headers and response status code
@@ -299,6 +338,9 @@ public Response<FileUploadInfo> upload(ByteBuf data, long length) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.upload#bytebuf-long-int-filerangewritetype}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs</a>.</p>
+     *
      * @param data The data which will upload to the storage file.
      * @param offset Optional starting point of the upload range. It will start from the beginning if it is {@code null}
      * @param length Specifies the number of bytes being transmitted in the request body. When the FileRangeWriteType is set to clear, the value of this header must be set to zero.
@@ -323,6 +365,11 @@ public Response<FileUploadInfo> upload(ByteBuf data, long length, int offset, Fi
      *
      * {@codesnippet com.azure.storage.file.fileClient.uploadFromFile#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs Create File</a>
+     * and
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs Upload</a>.</p>
+     *
      * @param uploadFilePath The path where store the source file to upload
      */
     public void uploadFromFile(String uploadFilePath) {
@@ -338,6 +385,11 @@ public void uploadFromFile(String uploadFilePath) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.uploadFromFile#string-filerangewritetype}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-file">Azure Docs Create File</a>
+     * and
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/put-range">Azure Docs Upload</a>.</p>
+     *
      * @param uploadFilePath The path where store the source file to upload
      * @param type You may specify one of the following options:
      * <ul>
@@ -358,6 +410,9 @@ public void uploadFromFile(String uploadFilePath, FileRangeWriteType type) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.listRanges}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-ranges">Azure Docs</a>.</p>
+     *
      * @return {@link FileRange ranges} in the files.
      */
     public Iterable<FileRange> listRanges() {
@@ -373,6 +428,9 @@ public Iterable<FileRange> listRanges() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.listRanges#filerange}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-ranges">Azure Docs</a>.</p>
+     *
      * @param range Optional byte range which returns file data only from the specified range.
      * @return {@link FileRange ranges} in the files that satisfy the requirements
      */
@@ -389,6 +447,9 @@ public Iterable<FileRange> listRanges(FileRange range) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.listHandles}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @return {@link HandleItem handles} in the files that satisfy the requirements
      */
     public Iterable<HandleItem> listHandles() {
@@ -404,6 +465,9 @@ public Iterable<HandleItem> listHandles() {
      *
      * {@codesnippet com.azure.storage.file.fileClient.listHandles#integer}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles">Azure Docs</a>.</p>
+     *
      * @param maxResults Optional max number of results returned per page
      * @return {@link HandleItem handles} in the file that satisfy the requirements
      */
@@ -422,6 +486,9 @@ public Iterable<HandleItem> listHandles(Integer maxResults) {
      *
      * {@codesnippet com.azure.storage.file.fileClient.forceCloseHandles#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles">Azure Docs</a>.</p>
+     *
      * @param handleId Specifies the handle ID to be closed. Use an asterisk ('*') as a wildcard string to specify all handles.
      * @return The counts of number of handles closed
      */
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceAsyncClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceAsyncClient.java
index 981b78a4ace5..e545c18965a5 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceAsyncClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceAsyncClient.java
@@ -99,6 +99,9 @@ public ShareAsyncClient getShareAsyncClient(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.listShares}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-shares">Azure Docs</a>.</p>
+     *
      * @return {@link ShareItem Shares} in the storage account without their metadata or snapshots
      */
     public Flux<ShareItem> listShares() {
@@ -127,6 +130,9 @@ public Flux<ShareItem> listShares() {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.listShares#ListSharesOptions.metadata.snapshot}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-shares">Azure Docs</a>.</p>
+     *
      * @param options Options for listing shares
      * @return {@link ShareItem Shares} in the storage account that satisfy the filter requirements
      */
@@ -196,6 +202,9 @@ private Publisher<ShareItem> extractAndFetchShares(ServicesListSharesSegmentResp
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-service-properties">Azure Docs</a>.</p>
+     *
      * @return Storage account File service properties
      */
     public Mono<Response<FileServiceProperties>> getProperties() {
@@ -220,6 +229,9 @@ public Mono<Response<FileServiceProperties>> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.setProperties#fileServiceProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-service-properties">Azure Docs</a>.</p>
+     *
      * @param properties Storage account File service properties
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException When one of the following is true
@@ -248,6 +260,9 @@ public Mono<VoidResponse> setProperties(FileServiceProperties properties) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.createShare#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @return A response containing the ShareAsyncClient and the status of creating the share.
      * @throws StorageErrorException If a share with the same name already exists
@@ -270,6 +285,9 @@ public Mono<Response<ShareAsyncClient>> createShare(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.createShare#string-map-integer.quota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @param metadata Optional metadata to associate with the share
      * @param quotaInGB Optional maximum size the share is allowed to grow to in GB. This must be greater than 0 and
@@ -294,6 +312,9 @@ public Mono<Response<ShareAsyncClient>> createShare(String shareName, Map<String
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.deleteShare#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
@@ -312,6 +333,9 @@ public Mono<VoidResponse> deleteShare(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceAsyncClient.deleteShare#string-string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @param snapshot Identifier of the snapshot
      * @return A response that only contains headers and response status code
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceClient.java
index 2dd4656926e1..f1603d94c448 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/FileServiceClient.java
@@ -75,6 +75,9 @@ public ShareClient getShareClient(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.listShares}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-shares">Azure Docs</a>.</p>
+     *
      * @return {@link ShareItem Shares} in the storage account without their metadata or snapshots
      */
     public Iterable<ShareItem> listShares() {
@@ -103,6 +106,9 @@ public Iterable<ShareItem> listShares() {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.listShares#ListSharesOptions.metadata.snapshot}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/list-shares">Azure Docs</a>.</p>
+     *
      * @param options Options for listing shares
      * @return {@link ShareItem Shares} in the storage account that satisfy the filter requirements
      */
@@ -120,6 +126,9 @@ public Iterable<ShareItem> listShares(ListSharesOptions options) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-service-properties">Azure Docs</a>.</p>
+     *
      * @return Storage account File service properties
      */
     public Response<FileServiceProperties> getProperties() {
@@ -143,6 +152,9 @@ public Response<FileServiceProperties> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.setProperties#fileServiceProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-service-properties">Azure Docs</a>.</p>
+     *
      * @param properties Storage account File service properties
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException When one of the following is true
@@ -167,8 +179,12 @@ public VoidResponse setProperties(FileServiceProperties properties) {
      * <p><strong>Code Samples</strong></p>
      *
      * <p>Create the share with share name of "myshare"</p>
+     *
      * {@codesnippet com.azure.storage.file.fileServiceClient.createShare#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @return A response containing the ShareClient and the status of creating the share.
      * @throws StorageErrorException If a share with the same name already exists
@@ -191,6 +207,9 @@ public Response<ShareClient> createShare(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.createShare#string-map-integer.quota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @param metadata Optional metadata to associate with the share
      * @param quotaInGB Optional maximum size the share is allowed to grow to in GB. This must be greater than 0 and
@@ -213,6 +232,9 @@ public Response<ShareClient> createShare(String shareName, Map<String, String> m
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.deleteShare#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
@@ -231,6 +253,9 @@ public VoidResponse deleteShare(String shareName) {
      *
      * {@codesnippet com.azure.storage.file.fileServiceClient.deleteShare#string-string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @param shareName Name of the share
      * @param snapshot Identifier of the snapshot
      * @return A response that only contains headers and response status code
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareAsyncClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareAsyncClient.java
index 789baa8a8181..eed4f7cb9190 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareAsyncClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareAsyncClient.java
@@ -134,6 +134,9 @@ public DirectoryAsyncClient getDirectoryClient(String directoryName) {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.create}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @return A response containing information about the share and the status its creation.
      * @throws StorageErrorException If the share already exists with different metadata
      */
@@ -154,6 +157,9 @@ public Mono<Response<ShareInfo>> create() {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.create#map-integer.quota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the share
      * @param quotaInGB Optional maximum size the share is allowed to grow to in GB. This must be greater than 0 and
      * less than or equal to 5120. The default value is 5120.
@@ -175,6 +181,9 @@ public Mono<Response<ShareInfo>> create(Map<String, String> metadata, Integer qu
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.createSnapshot}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-share">Azure Docs</a>.</p>
+     *
      * @return A response containing information about the snapshot of share.
      * @throws StorageErrorException If the share doesn't exist, there are 200 snapshots of the share, or a snapshot is
      * in progress for the share
@@ -192,6 +201,9 @@ public Mono<Response<ShareSnapshotInfo>> createSnapshot() {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.createSnapshot#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-share">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the snapshot. If {@code null} the metadata of the share
      * will be copied to the snapshot.
      * @return A response containing information about the snapshot of share.
@@ -212,6 +224,9 @@ public Mono<Response<ShareSnapshotInfo>> createSnapshot(Map<String, String> meta
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -230,6 +245,9 @@ public Mono<VoidResponse> delete() {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties">Azure Docs</a>.</p>
+     *
      * @return the properties of the share
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -247,6 +265,9 @@ public Mono<Response<ShareProperties>> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.setQuota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties">Azure Docs</a>.</p>
+     *
      * @param quotaInGB Size in GB to limit the share's growth. The quota in GB must be between 1 and 5120.
      * @return information about the share
      * @throws StorageErrorException If the share doesn't exist or {@code quotaInGB} is outside the allowed bounds
@@ -271,6 +292,9 @@ public Mono<Response<ShareInfo>> setQuota(int quotaInGB) {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.clearMetadata#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Metadata to set on the share, if null is passed the metadata for the share is cleared
      * @return information about the share
      * @throws StorageErrorException If the share doesn't exist or the metadata contains invalid keys
@@ -289,6 +313,9 @@ public Mono<Response<ShareInfo>> setMetadata(Map<String, String> metadata) {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.getAccessPolicy}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-acl">Azure Docs</a>.</p>
+     *
      * @return The stored access policies specified on the queue.
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -306,6 +333,9 @@ public Flux<SignedIdentifier> getAccessPolicy() {
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.setAccessPolicy}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-acl">Azure Docs</a>.</p>
+     *
      * @param permissions Access policies to set on the queue
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist, a stored access policy doesn't have all fields filled out,
@@ -325,6 +355,9 @@ public Mono<Response<ShareInfo>> setAccessPolicy(List<SignedIdentifier> permissi
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.getStatistics}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-stats">Azure Docs</a>.</p>
+     *
      * @return the storage statistics of the share
      */
     public Mono<Response<ShareStatistics>> getStatistics() {
@@ -340,7 +373,10 @@ public Mono<Response<ShareStatistics>> getStatistics() {
      * <p>Create the directory "mydirectory"</p>
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.createDirectory#string}
-     *      *
+     *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @return A response containing a {@link DirectoryAsyncClient} to interact with the created directory and the
      * status of its creation.
@@ -360,6 +396,9 @@ public Mono<Response<DirectoryAsyncClient>> createDirectory(String directoryName
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.createDirectory#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @param metadata Optional metadata to associate with the directory
      * @return A response containing a {@link DirectoryAsyncClient} to interact with the created directory and the
@@ -382,6 +421,9 @@ public Mono<Response<DirectoryAsyncClient>> createDirectory(String directoryName
      *
      * {@codesnippet com.azure.storage.file.shareAsyncClient.deleteDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist or the directory isn't empty
diff --git a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareClient.java b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareClient.java
index 2d5c1859eee2..d5c5ee54b5eb 100644
--- a/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareClient.java
+++ b/sdk/storage/azure-storage-file/src/main/java/com/azure/storage/file/ShareClient.java
@@ -84,6 +84,9 @@ public DirectoryClient getDirectoryClient(String directoryName) {
      *
      * {@codesnippet com.azure.storage.file.shareClient.create}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @return A response containing information about the share and the status its creation.
      * @throws StorageErrorException If the share already exists with different metadata
      */
@@ -104,6 +107,9 @@ public Response<ShareInfo> create() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.create#map-integer.quota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-share">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the share
      * @param quotaInGB Optional maximum size the share is allowed to grow to in GB. This must be greater than 0 and
      * less than or equal to 5120. The default value is 5120.
@@ -122,7 +128,9 @@ public Response<ShareInfo> create(Map<String, String> metadata, Integer quotaInG
      *
      * <p>Create a snapshot</p>
      *
-     * {@codesnippet com.azure.storage.file.shareClient.createSnapshot}
+     *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-share">Azure Docs</a>.</p>
      *
      * @return A response containing information about the snapshot of share.
      * @throws StorageErrorException If the share doesn't exist, there are 200 snapshots of the share, or a snapshot is
@@ -141,6 +149,9 @@ public Response<ShareSnapshotInfo> createSnapshot() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.createSnapshot#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-share">Azure Docs</a>.</p>
+     *
      * @param metadata Optional metadata to associate with the snapshot. If {@code null} the metadata of the share
      * will be copied to the snapshot.
      * @return A response containing information about the snapshot of share.
@@ -160,6 +171,9 @@ public Response<ShareSnapshotInfo> createSnapshot(Map<String, String> metadata)
      *
      * {@codesnippet com.azure.storage.file.shareClient.delete}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share">Azure Docs</a>.</p>
+     *
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -177,6 +191,9 @@ public VoidResponse delete() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.getProperties}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties">Azure Docs</a>.</p>
+     *
      * @return the properties of the share
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -193,6 +210,9 @@ public Response<ShareProperties> getProperties() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.setQuota}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties">Azure Docs</a>.</p>
+     *
      * @param quotaInGB Size in GB to limit the share's growth. The quota in GB must be between 1 and 5120.
      * @return information about the share
      * @throws StorageErrorException If the share doesn't exist or {@code quotaInGB} is outside the allowed bounds
@@ -216,6 +236,9 @@ public Response<ShareInfo> setQuota(int quotaInGB) {
      *
      * {@codesnippet com.azure.storage.file.shareClient.clearMetadata#map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-metadata">Azure Docs</a>.</p>
+     *
      * @param metadata Metadata to set on the share, if null is passed the metadata for the share is cleared
      * @return information about the share
      * @throws StorageErrorException If the share doesn't exist or the metadata contains invalid keys
@@ -233,6 +256,9 @@ public Response<ShareInfo> setMetadata(Map<String, String> metadata) {
      *
      * {@codesnippet com.azure.storage.file.shareClient.getAccessPolicy}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-acl">Azure Docs</a>.</p>
+     *
      * @return The stored access policies specified on the queue.
      * @throws StorageErrorException If the share doesn't exist
      */
@@ -249,6 +275,9 @@ public Iterable<SignedIdentifier> getAccessPolicy() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.setAccessPolicy}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-acl">Azure Docs</a>.</p>
+     *
      * @param permissions Access policies to set on the queue
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist, a stored access policy doesn't have all fields filled out,
@@ -267,6 +296,9 @@ public Response<ShareInfo> setAccessPolicy(List<SignedIdentifier> permissions) {
      *
      * {@codesnippet com.azure.storage.file.shareClient.getStatistics}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-stats">Azure Docs</a>.</p>
+     *
      * @return the storage statistics of the share
      */
     public Response<ShareStatistics> getStatistics() {
@@ -282,6 +314,9 @@ public Response<ShareStatistics> getStatistics() {
      *
      * {@codesnippet com.azure.storage.file.shareClient.createDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @return A response containing a {@link DirectoryClient} to interact with the created directory and the
      * status of its creation.
@@ -301,6 +336,9 @@ public Response<DirectoryClient> createDirectory(String directoryName) {
      *
      * {@codesnippet com.azure.storage.file.shareClient.createDirectory#string-map}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @param metadata Optional metadata to associate with the directory
      * @return A response containing a {@link DirectoryAsyncClient} to interact with the created directory and the
@@ -323,6 +361,9 @@ public Response<DirectoryClient> createDirectory(String directoryName, Map<Strin
      *
      * {@codesnippet com.azure.storage.file.shareClient.deleteDirectory#string}
      *
+     * <p>For more information, see the
+     * <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory">Azure Docs</a>.</p>
+     *
      * @param directoryName Name of the directory
      * @return A response that only contains headers and response status code
      * @throws StorageErrorException If the share doesn't exist or the directory isn't empty