Edits

Author: pauljewellmsft

articles/storage/files/storage-dotnet-how-to-use-files.md

@@ -5,7 +5,7 @@ description: Learn how to develop .NET applications and services that use Azure
 author: pauljewellmsft
 ms.service: azure-file-storage
 ms.topic: conceptual
-ms.date: 03/13/2025
+ms.date: 03/31/2025
 ms.author: pauljewell
 ms.devlang: csharp
 ms.custom: devx-track-csharp, devx-track-dotnet
@@ -261,11 +261,11 @@ static void LockFile(string filePath)
 }
 ```
 
-When using both SMB and the FileREST API, be aware that the FileREST API uses [leases](#example-lease-a-file-using-the-file-shares-client-library) to manage file locks, while SMB uses file system locks managed by the operating system. To learn more about managing file locking interactions between SMB and the FileREST API, see [Manage file locks](/rest/api/storageservices/managing-file-locks).
+When using both SMB and the FileREST API, keep in mind that the FileREST API uses [leases](#example-lease-a-file-using-the-file-shares-client-library) to manage file locks, while SMB uses file system locks managed by the operating system. To learn more about managing file locking interactions between SMB and the FileREST API, see [Manage file locks](/rest/api/storageservices/managing-file-locks).
 
 ### Example: Enumerate file ACLs using System.IO
 
-The following code example shows how to enumerate ACLs for a file:
+The following code example shows how to enumerate access control lists (ACLs) for a file:
 
 ```csharp
 using System.IO;
@@ -393,7 +393,7 @@ ShareClient shareClient = new ShareClient(connectionString, shareName);
 For information about how to obtain account keys and best practice guidelines for properly managing and safeguarding your keys, see [Manage storage account access keys](../common/storage-account-keys-manage.md).
 
 > [!IMPORTANT]
-> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
+> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service can become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
 
 ---
 
@@ -449,7 +449,7 @@ await destShareFileClient.StartCopyAsync(srcShareFileClient.Uri);
 
 A lease creates a lock on a file that's managed by Azure via a lease ID. The lease provides a mechanism to coordinate access to files across multiple clients in a distributed system. A lease on a file provides exclusive write and delete access. To learn more about lease states and actions, see [Lease File](/rest/api/storageservices/lease-file#remarks).
 
-The following code example shows how to create a lease client, acquire a infinite duration lease on a file, and release the lease:
+The following code example shows how to create a lease client, acquire an infinite duration lease on a file, and release the lease:
 
 ```csharp
 using Azure.Core;
@@ -485,7 +485,7 @@ await leaseClient.AcquireAsync(duration: ShareLeaseClient.InfiniteLeaseDuration)
 await leaseClient.ReleaseAsync();
 ```
 
-When using both SMB and the FileREST API, be aware that the FileREST API uses [leases](#example-lease-a-file-using-the-file-shares-client-library) to manage file locks, while SMB uses file system locks managed by the operating system. To learn more about managing file locking interactions between SMB and the FileREST API, see [Manage file locks](/rest/api/storageservices/managing-file-locks).
+When using both SMB and the FileREST API, keep in mind that the FileREST API uses [leases](#example-lease-a-file-using-the-file-shares-client-library) to manage file locks, while SMB uses file system locks managed by the operating system. To learn more about managing file locking interactions between SMB and the FileREST API, see [Manage file locks](/rest/api/storageservices/managing-file-locks).
 
 ### Example: Create and list share snapshots using the File Shares client library
 

articles/storage/files/storage-files-developer-overview.md

@@ -5,7 +5,7 @@ description: Learn how to develop applications and services that use Azure Files
 author: pauljewellmsft
 ms.service: azure-file-storage
 ms.topic: conceptual
-ms.date: 03/13/2025
+ms.date: 03/31/2025
 ms.author: pauljewell
 ---
 
@@ -19,7 +19,7 @@ Azure Files offers several ways for developers to access data and manage resourc
 
 | Approach | How it works | When to use |
 | --- | --- | --- |
-| [Standard file I/O libraries](#standard-file-io-libraries) | Uses OS-level API calls through Azure file shares mounted using SMB or NFS. When you mount a file share using SMB/NFS, you can use file I/O libraries for a programming language or framework, such as `System.IO` for .NET, `os` and `io` for Python, `java.io` for Java, or `fs` for JavaScript (Node.js). | You have line-of-business apps with existing code that uses standard file I/O, and you don't want to rewrite code for the app to work with an Azure file share. |
+| [Standard file I/O libraries](#standard-file-io-libraries) | Uses OS-level API calls through Azure file shares mounted using the industry standard Server Message Block (SMB) and Network File System (NFS) protocols. When you mount a file share using SMB/NFS, you can use file I/O libraries for a programming language or framework, such as `System.IO` for .NET, `os` and `io` for Python, `java.io` for Java, or `fs` for JavaScript (Node.js). | You have line-of-business apps with existing code that uses standard file I/O, and you don't want to rewrite code for the app to work with an Azure file share. |
 | [FileREST API](#filerest-api)| Directly calls HTTPS endpoints to interact with data stored in Azure Files. Provides programmatic control over file share resources. The Azure SDK provides client libraries that build on the FileREST API, allowing you interact with FileREST API operations through familiar programming language paradigms. | You're building value-added cloud services and apps for customers and you want to use advanced features not available through native protocols. |
 | [Storage resource provider REST API](#storage-resource-provider-rest-api) | Uses Azure Resource Manager (ARM) to manage storage accounts and file shares. Calls REST API endpoints for various resource management operations. | Your app or service needs to perform resource management tasks, such as creating, deleting, or updating storage accounts or file shares. |
 
@@ -60,7 +60,7 @@ The Azure SDK provides two sets of libraries for working with Azure Files resour
 
 ### Libraries for data access
 
-Data plane libraries are designed to handle data access operations at the *directory* or *file* level. The following section shows the File Shares client library for .NET, Java, Python, JavaScript, and Go.
+Data plane libraries are designed to handle data access operations at the *directory* or *file* level. The following sections show the File Shares client library for .NET, Java, Python, JavaScript, and Go.
 
 ### [.NET](#tab/dotnet)
 
@@ -114,7 +114,7 @@ The following table shows the File Shares client library for data access:
 
 Control plane libraries build on top of the Azure Storage resource provider REST API, allowing you to manage Azure Storage resources. The Azure Storage resource provider is a service that is based on [Azure Resource Manager](/azure/azure-resource-manager/management/overview), and supports both declarative (templates) and imperative (direct API call) methods.
 
-Resource management libraries are designed to handle resource management operations at the *file service* or *file share* level. To learn more about the operations, see [File Services](/rest/api/storagerp/file-services) or [File Shares](/rest/api/storagerp/file-shares). The following section shows the Azure Storage management libraries for .NET, Java, Python, JavaScript, and Go.
+Resource management libraries are designed to handle resource management operations at the *file service* or *file share* level. To learn more about the operations, see [File Services](/rest/api/storagerp/file-services) or [File Shares](/rest/api/storagerp/file-shares). The following sections show the Azure Storage management libraries for .NET, Java, Python, JavaScript, and Go.
 
 ## [.NET](#tab/dotnet)