Merge pull request #213792 from ktoliver/blobfuse2

edit pass: BlobFuse2 articles (1986763)

Author: ShawnJackson

articles/storage/blobs/TOC.yml

@@ -540,15 +540,15 @@ items:
           href: ../common/storage-use-azcopy-troubleshoot.md?toc=/azure/storage/blobs/toc.json
       - name: BlobFuse
         items:
-        - name: What is BlobFuse2?
+        - name: What is BlobFuse2 Preview?
           href: blobfuse2-what-is.md
         - name: Deploy BlobFuse2 on Linux
           href: blobfuse2-how-to-deploy.md
         - name: Deploy BlobFuse v1 on Linux
           href: storage-how-to-mount-container-linux.md
-        - name: Health Monitor
+        - name: Health Monitor for BlobFuse2
           href: blobfuse2-health-monitor.md
-        - name: Troubleshooting
+        - name: Troubleshoot BlobFuse2
           href: blobfuse2-troubleshooting.md
       - name: Azure Data Factory
         href: ../../data-factory/connector-azure-blob-storage.md?toc=/azure/storage/blobs/toc.json
@@ -752,7 +752,7 @@ items:
         href: ../common/storage-ref-azcopy-set-properties.md?toc=/azure/storage/blobs/toc.json
     - name: BlobFuse2
       items:
-      - name: Configuration settings
+      - name: Configure settings
         href: blobfuse2-configuration.md?toc=/azure/storage/blobs/toc.json
       - name: Commands
         items:

articles/storage/blobs/blobfuse2-configuration.md

@@ -1,77 +1,82 @@
 ---
-title: How to configure Blobfuse2 (preview) | Microsoft Docs
+title: Configure settings for BlobFuse2 Preview
 titleSuffix: Azure Blob Storage
-description: How to configure Blobfuse2 (preview).
+description: Learn about your options for setting and changing configuration settings for BlobFuse2 Preview.
 author: jimmart-dev
+ms.author: jammart
+ms.reviewer: tamram
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
 ms.date: 09/29/2022
-ms.author: jammart
-ms.reviewer: tamram
 ---
 
-# How to configure Blobfuse2 (preview)
+# Configure settings for BlobFuse2 Preview
 
-> [!IMPORTANT]
-> BlobFuse2 is the next generation of BlobFuse and is currently in preview.
-> This preview version is provided without a service level agreement, and is not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
->
-> If you need to use BlobFuse in a production environment, BlobFuse v1 is generally available (GA). For information about the GA version, see:
->
-> - [The BlobFuse v1 setup documentation](storage-how-to-mount-container-linux.md)
-> - [The BlobFuse v1 project on GitHub](https://github.com/Azure/azure-storage-fuse/tree/master)
-
-BlobFuse2 uses a variety of configuration settings to control its behaviors, including:
+You can use configuration settings to manage BlobFuse2 Preview in your deployment. Through configuration settings, you can set these aspects of how BlobFuse2 works in your environment:
 
 - Access to a storage blob
 - Logging
 - Pipeline engagement
 - Caching behavior
 - Permissions
 
-For a complete list of settings and their descriptions, see [the base configuration file on GitHub](https://github.com/Azure/azure-storage-fuse/blob/main/setup/baseConfig.yaml).
+For a list of all BlobFuse2 settings and their descriptions, see the [base configuration file on GitHub](https://github.com/Azure/azure-storage-fuse/blob/main/setup/baseConfig.yaml).
 
-There are 3 ways of managing configuration settings for BlobFuse2 (in order of precedence):
+> [!IMPORTANT]
+> BlobFuse2 is the next generation of BlobFuse and currently is in preview. The preview version is provided without a service-level agreement. We recommend that you don't use the preview version for production workloads. In BlobFuse2 Preview, some features might not be supported or might have constrained capabilities. For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+>
+> To use BlobFuse in a production environment, use the BlobFuse v1 general availability (GA) version. For information about the GA version, see:
+>
+> - [Mount Azure Blob Storage as a file system by using BlobFuse v1](storage-how-to-mount-container-linux.md)
+> - [BlobFuse v1 project on GitHub](https://github.com/Azure/azure-storage-fuse/tree/master)
+To manage configuration settings for BlobFuse2, you have three options (in order of precedence):
+
+(1) [Configuration file](#configuration-file)
+
+(2) [Environment variables](#environment-variables)
 
-1. [CLI parameters](#cli-parameters)
-1. [Environment variables](#environment-variables)
-1. [A configuration file](#configuration-file)
+(3) [CLI parameters](#cli-parameters)
 
-Using a configuration file is the preferred method, but the other methods can be useful in some circumstances.
+Using a configuration file is the preferred method, but the other methods might be useful in some circumstances.
 
 ## Configuration file
 
-Creating a configuration file is the preferred method of establishing settings for BlobFuse2. Once you have specified the desired settings in the file, reference the configuration file when using the `blobfuse2 mount` or other commands. Example:
+Creating a configuration file is the preferred method to establish settings for BlobFuse2. When you've specified the settings you want in the configuration file, reference the configuration file when you use `blobfuse2 mount` or other commands. 
+
+Here's an example:
 
 ````bash
 blobfuse2 mount ./mount --config-file=./config.yaml
 ````
 
-The [Base BlobFuse2 configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/setup/baseConfig.yaml) contains a complete list of all settings and a brief explanation of each.
+The [BlobFuse2 base configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/setup/baseConfig.yaml) contains a list of all settings and a brief explanation of each setting.
 
-Use the [Sample file cache configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/sampleFileCacheConfig.yaml) or [the sample streaming configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/sampleStreamingConfig.yaml) to get started quickly using some basic settings for each of those scenarios.
+Use the [sample file cache configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/sampleFileCacheConfig.yaml) or the [sample streaming configuration file](https://github.com/Azure/azure-storage-fuse/blob/main/sampleStreamingConfig.yaml) to get started quickly by using some basic settings for each of those scenarios.
 
 ## Environment variables
 
-Setting environment variables is another way to configure some BlobFuse2 settings. The supported environment variables are useful for specifying the blob storage container to be accessed and the authorization method.
-
-For more details on using environment variables, see [The environment variables documentation](https://github.com/Azure/azure-storage-fuse/tree/main#environment-variables)
+Setting environment variables is another way to configure some BlobFuse2 settings. The supported environment variables are useful for specifying the Azure Blob Storage container to access and the authorization method to use.
 
-See [the BlobFuse2 README](https://github.com/Azure/azure-storage-fuse/tree/main#environment-variables) for a complete list of variables that can be used.
+For more information about using environment variables and a list of all variables you can use, see the [BlobFuse2 README](https://github.com/Azure/azure-storage-fuse/tree/main#environment-variables).
 
-## CLI Parameters
+## CLI parameters
 
-Configuration settings can be set when passed as parameters of the BlobFuse2 command set, such as the `blobfuse2 mount` command. The mount command typically references a configuration file that contains all of the settings, but individual settings in the configuration file can be overridden by CLI parameters. In this example, the config.yaml configuration file is referenced, but the container to be mounted and the logging options are overridden:
+You also can set configuration settings when you pass them as parameters of the BlobFuse2 command set, such as by using the `blobfuse2 mount` command. The mount command typically references a configuration file that contains all the settings. But you can use CLI parameters to override individual settings in the configuration file. In this example, the *config.yaml* configuration file is referenced, but the container to be mounted and the logging options are overridden:
 
 ```bash
 blobfuse2 mount ./mount_dir --config-file=./config.yaml --container-name=blobfuse2b --log-level=log_debug --log-file-path=./bobfuse2b.log
 ```
 
-For more information about the complete BlobFuse2 command set, including the `blobfuse2 mount` command, see [The BlobFuse2 command set reference (preview)](blobfuse2-commands.md) and [The BlobFuse2 mount command reference (preview)](blobfuse2-commands-mount.md).
+For more information about the entire BlobFuse2 command set, including the `blobfuse2 mount` command, see [BlobFuse2 commands](blobfuse2-commands.md) and [BlobFuse2 mount commands](blobfuse2-commands-mount.md).
 
 ## See also
 
-- [What is BlobFuse2? (preview)](blobfuse2-what-is.md)
-- [How to mount an Azure blob storage container on Linux with BlobFuse2 (preview)](blobfuse2-how-to-deploy.md)
+- [Migrate to BlobFuse2 from BlobFuse v1](https://github.com/Azure/azure-storage-fuse/blob/main/MIGRATION.md)
+- [BlobFuse2 commands](blobfuse2-commands.md)
+- [Troubleshoot BlobFuse2 issues](blobfuse2-troubleshooting.md)
+
+## Next steps
+
+- [Mount an Azure Blob Storage container on Linux by using BlobFuse2](blobfuse2-how-to-deploy.md)
+- [Use Health Monitor to gain insights into BlobFuse2 mount activities and resource usage](blobfuse2-health-monitor.md)

articles/storage/blobs/blobfuse2-health-monitor.md

@@ -1,37 +1,35 @@
 ---
-title: How to use BlobFuse2 Health Monitor to gain insights into BlobFuse2 mount activities and resource usage (preview) | Microsoft Docs
+title: Use BlobFuse2 Preview Health Monitor to monitor mount activities and resource usage
 titleSuffix: Azure Blob Storage
-description: How to use BlobFuse2 Health Monitor to gain insights into BlobFuse2 mount activities and resource usage (preview).
-author: jammart
+description: Learn how to use BlobFuse2 Health Monitor to gain insights into BlobFuse2 Preview mount activities and resource usage.
+author: jimmart-dev
+ms.author: jammart
+ms.reviewer: tamram
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
 ms.date: 09/26/2022
-ms.author: jammart
-ms.reviewer: tamram
 ---
 
-# Use Health Monitor to gain insights into BlobFuse2 mounts (preview)
+# Use Health Monitor to gain insights into BlobFuse2 Preview mounts
 
-This article provides references to assist in deploying and using BlobFuse2 Health Monitor to gain insights into BlobFuse2 mount activities and resource usage.
+This article provides references to help you deploy and use BlobFuse2 Preview Health Monitor to gain insights into BlobFuse2 mount activities and resource usage.
 
 > [!IMPORTANT]
-> BlobFuse2 is the next generation of BlobFuse and is currently in preview.
-> This preview version is provided without a service level agreement, and might not suitable for production workloads. Certain features might not be supported or might have constrained capabilities.
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+> BlobFuse2 is the next generation of BlobFuse and currently is in preview. The preview version is provided without a service-level agreement. We recommend that you don't use the preview version for production workloads. In BlobFuse2 Preview, some features might not be supported or might have constrained capabilities. For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 >
-> If you need to use BlobFuse in a production environment, BlobFuse v1 is generally available (GA). For information about the GA version, see:
+> To use BlobFuse in a production environment, use the BlobFuse v1 general availability (GA) version. For information about the GA version, see:
 >
-> - [The BlobFuse v1 setup documentation](storage-how-to-mount-container-linux.md)
-> - [The BlobFuse v1 project on GitHub](https://github.com/Azure/azure-storage-fuse/tree/master)
+> - [Mount Azure Blob Storage as a file system by using BlobFuse v1](storage-how-to-mount-container-linux.md)
+> - [BlobFuse v1 project on GitHub](https://github.com/Azure/azure-storage-fuse/tree/master)
 
 You can use BlobFuse2 Health Monitor to:
 
 - Get statistics about internal activities related to BlobFuse2 mounts
 - Monitor CPU, memory, and network usage by BlobFuse2 mount processes
 - Track file cache usage and events
 
-## BlobFuse2 Health Monitor Resources
+## BlobFuse2 Health Monitor resources
 
 During the preview of BlobFuse2, refer to [the BlobFuse2 Health Monitor README on GitHub](https://github.com/Azure/azure-storage-fuse/blob/main/tools/health-monitor/README.md) for full details on how to deploy and use Health Monitor. The README file describes:
 
@@ -41,6 +39,11 @@ During the preview of BlobFuse2, refer to [the BlobFuse2 Health Monitor README o
 
 ## See also
 
-- [What is BlobFuse2? (preview)](blobfuse2-what-is.md)
-- [BlobFuse2 configuration reference (preview)](blobfuse2-configuration.md)
-- [How to mount an Azure blob storage container on Linux with BlobFuse2 (preview)](blobfuse2-how-to-deploy.md)
+- [Migrate to BlobFuse2 from BlobFuse v1](https://github.com/Azure/azure-storage-fuse/blob/main/MIGRATION.md)
+- [BlobFuse2 commands](blobfuse2-commands.md)
+- [Troubleshoot BlobFuse2 issues](blobfuse2-troubleshooting.md)
+
+## Next steps
+
+- [Configure settings for BlobFuse2](blobfuse2-configuration.md)
+- [Use Health Monitor to gain insights into BlobFuse2 mount activities and resource usage](blobfuse2-health-monitor.md)