Merge pull request #270110 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/azure-docs (branch main)

Author: Taojunshen

articles/ai-services/language-service/question-answering/concepts/best-practices.md

@@ -63,9 +63,9 @@ Custom question answering provides the flexibility to use synonyms at the projec
 
 For better relevance, you need to provide a list of acronyms that the end user intends to use interchangeably. The following is a list of acceptable acronyms:
 
-`MSFT` – Microsoft
-`ID` – Identification
-`ETA` – Estimated time of Arrival
+* `MSFT` – Microsoft
+* `ID` – Identification
+* `ETA` – Estimated time of Arrival
 
 Other than acronyms, if you think your words are similar in context of a particular domain and generic language models won’t consider them similar, it’s better to add them as synonyms. For instance, if an auto company producing a car model X receives queries such as “my car’s audio isn’t working” and the project has questions on “fixing audio for car X”, then we need to add ‘X’ and ‘car’ as synonyms.
 

articles/ai-services/language-service/question-answering/tutorials/active-learning.md

@@ -40,7 +40,7 @@ curl "https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob
 
 ## Import file
 
-From the edit project pane for your project, select the `...` (ellipsis) icon from the menu > **Import questions and answers** > **Import as TSV**. The select **Choose file** to browse to the copy of `SampleActiveLearning.tsv` that you downloaded to your computer in the previous step, and then select done.
+From the edit project pane for your project, select the `...` (ellipsis) icon from the menu > **Import questions and answers** > **Import as TSV**. Then, select **Choose file** to browse to the copy of `SampleActiveLearning.tsv` that you downloaded to your computer in the previous step, and then select done.
 
 > [!div class="mx-imgBorder"]
 > [ ![Screenshot of edit project menu bar with import as TSV option displayed.]( ../media/active-learning/import-questions.png) ]( ../media/active-learning/import-questions.png#lightbox)

articles/iot-operations/manage-mqtt-connectivity/howto-configure-availability-scale.md

@@ -36,10 +36,11 @@ The `cardinality` field is a nested field that has these subfields:
 
 - `frontend`: This subfield defines the settings for the frontend pods, such as:
   - `replicas`: The number of frontend pods to deploy. This subfield is required if the `mode` field is set to `distributed`.
+  - `workers`: The number of workers to deploy per frontend, currently it must be set to `1`. This subfield is required if the `mode` field is set to `distributed`.
 - `backendChain`: This subfield defines the settings for the backend chains, such as:
   - `redundancyFactor`: The number of data copies in each backend chain. This subfield is required if the `mode` field is set to `distributed`.
   - `partitions`: The number of partitions to deploy. This subfield is required if the `mode` field is set to `distributed`.
-  - `workers`: The number of workers to deploy, currently it must be set to `1`. This subfield is required if the `mode` field is set to `distributed`.
+  - `workers`: The number of workers to deploy per backend, currently it must be set to `1`. This subfield is required if the `mode` field is set to `distributed`.
 
 ## Configure memory profile
 

articles/migrate/appcat/dotnet.md

@@ -44,7 +44,7 @@ Use the following steps to install it from inside Visual Studio. Alternatively,
 
 ### Prerequisites
 
-- .NET SDK
+- .NET SDK (6 or greater)
 
 ### Installation steps
 

articles/stream-analytics/write-to-delta-lake.md

@@ -84,8 +84,7 @@ At the failure of schema conversion, the job behavior will follow the [output da
 
 ### Delta Log checkpoints
 
-
-The Stream Analytics job will create Delta Log checkpoints periodically.
+The Stream Analytics job will create [Delta Log checkpoints](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#checkpoints-1) periodically in the V1 format. Delta Log checkpoints are snapshots of the Delta Table and will typically contain the name of the data file generated by the Stream Analytics job. If the amount of data files is large, then this will lead to large checkpoints which can cause memory issues in the Stream Analytics Job.
 
 ## Limitations
 
@@ -100,6 +99,14 @@ The Stream Analytics job will create Delta Log checkpoints periodically.
 - Writing to existing tables of Writer Version 7 or above with writer features will fail.
     - Example: Writing to existing tables with [Deletion Vectors](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#deletion-vectors) enabled will fail.
     - The exceptions here are the [changeDataFeed and appendOnly Writer Features](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#valid-feature-names-in-table-features).
+- When a Stream Analytics job writes a batch of data to a Delta Lake, it can generate multiple [Add File Action](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#add-file-and-remove-file). When there are too many Add File Actions generated for a single batch, a Stream Analytics Job can be stuck.
+    - The number of Add File Actions generated are determined by a number of factors:
+        - Size of the batch. This is determined by the data volume and the batching parameters [Minimum Rows and Maximum Time](https://learn.microsoft.com/azure/stream-analytics/blob-storage-azure-data-lake-gen2-output#output-configuration)
+        - Cardinality of the [Partition Column values](https://learn.microsoft.com/azure/stream-analytics/write-to-delta-lake#delta-lake-configuration) of the batch.
+    - To reduce the number of Add File Actions generated for a batch the following steps can be taken:
+        - Reduce the batching configurations [Minimum Rows and Maximum Time](https://learn.microsoft.com/azure/stream-analytics/blob-storage-azure-data-lake-gen2-output#output-configuration)
+        - Reduce the cardinality of the [Partition Column values](https://learn.microsoft.com/azure/stream-analytics/write-to-delta-lake#delta-lake-configuration) by tweaking the input data or choosing a different partition column
+- Stream Analytics jobs can only read and write single part V1 Checkpoints. Multi-part checkpoints and the Checkpoint V2 format are not supported.
 
 ## Next steps
 

articles/virtual-machine-scale-sets/virtual-machine-scale-sets-automatic-upgrade.md

@@ -13,7 +13,7 @@ ms.reviewer: mimckitt
 # Azure Virtual Machine Scale Set automatic OS image upgrades
 
 > [!NOTE]
-> Many of the steps listed in this document apply to Virtual Machine Scale Sets using Uniform Orchestration mode. We recommend using Flexible Orchestration for new workloads. For more information, see [Orchesration modes for Virtual Machine Scale Sets in Azure](virtual-machine-scale-sets-orchestration-modes.md).
+> Many of the steps listed in this document apply to Virtual Machine Scale Sets using Uniform Orchestration mode. We recommend using Flexible Orchestration for new workloads. For more information, see [Orchestration modes for Virtual Machine Scale Sets in Azure](virtual-machine-scale-sets-orchestration-modes.md).
 
 Enabling automatic OS image upgrades on your scale set helps ease update management by safely and automatically upgrading the OS disk for all instances in the scale set.