Some acrolynx

Author: Mike Ray (Microsoft)

articles/azure-arc/data/toc.yml

@@ -236,7 +236,7 @@ items:
           items:
             - name: General
               href: troubleshoot-managed-instance.md
-            - name: configuration
+            - name: Configuration
               href: troubleshoot-managed-instance-configuration.md
 - name: Azure Arc-enabled PostgreSQL (preview) 
   items:

articles/azure-arc/data/troubleshoot-managed-instance-configuration.md

@@ -9,18 +9,20 @@ ms.date: 04/10/2023
 
 # User-provided configuration files
 
-Arc data services provide management of configuration settings and files in the system. Configuration files such as `mssql.conf`, `mssql.json`, `krb5.conf` are generated by the system using the user-provided settings in the custom resource spec as well as some system-determined settings. The scope of what settings are supported and what changes can be made to the configuration files using the custom resource spec evolves over time. You may need to try changes in the configuration files that are not possible through the settings on the custom resource spec.
+Arc data services provide management of configuration settings and files in the system. The system generates configuration files such as `mssql.conf`, `mssql.json`, `krb5.conf` using the user-provided settings in the custom resource spec and some system-determined settings. The scope of what settings are supported and what changes can be made to the configuration files using the custom resource spec evolves over time. You may need to try changes in the configuration files that aren't possible through the settings on the custom resource spec.
 
-To alleviate this problem, Arc data services allow you to to provide configuration file content for a selected set of files through a Kubernetes `ConfigMap`. The information in the `ConfigMap` effectively overrides the file content that the system would have otherwise generated. This allows you to try some scenarios that may not be possible through the spec today.
+To alleviate this problem, you can provide configuration file content for a selected set of files through a Kubernetes `ConfigMap`. The information in the `ConfigMap` effectively overrides the file content that the system would have otherwise generated. This content allows you to try some configuration settings.
+
+For Arc SQL Managed Instance, the supported configuration files that you can override using this method are:
 
-For Arc SQL Managed Instance, the supported configuration files that can be overridden using this method are:
 - `mssql.conf`
 - `mssql.json`
 - `krb5.conf`
 
 ## Steps to provide override configuration files
 
 ### 1. Prepare the content of the configuration file
+
 Prepare the content of the file that you would like to provide an override for.
 
 ### 2. Create a `ConfigMap`
@@ -61,13 +63,15 @@ spec:
   ...
 ```
 
-Apply the SQL Managed Instance spec in Kubernetes. This will lead to the delivery of the provided configuration files to Arc SQL Managed Instance container.
+Apply the SQL Managed Instance spec in Kubernetes. This action leads to the delivery of the provided configuration files to Arc SQL Managed Instance container.
 
 ### 4. Check that the files are downloaded in the arc-sqlmi container.
-The locations of supported files in the container are as follows:
-1. mssql.conf: /var/run/config/mssql/mssql.conf
-1. mssql.json: /var/run/config/mssql/mssql.json
-1. krb5.conf: /etc/krb5.conf
+
+The locations of supported files in the container are:
+
+- `mssql.conf`: `/var/run/config/mssql/mssql.conf`
+- `mssql.json`: `/var/run/config/mssql/mssql.json`
+- `krb5.conf`: `/etc/krb5.conf`
 
 
 ## Next steps