Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into two-azure-monitor-topics

Author: paulth1

articles/cognitive-services/Computer-vision/concept-recognizing-text.md

@@ -22,10 +22,9 @@ Computer Vision provides a number of services that detect and extract printed or
 
 The Read API detects text content in an image using our latest recognition models and converts the identified text into a machine-readable character stream. It's optimized for text-heavy images (such as documents that have been digitally scanned) and for images with a lot of visual noise. It will determine which recognition model to use for each line of text, supporting images with both printed and handwritten text. The Read API executes asynchronously because larger documents can take several minutes to return a result.
 
-The Read operation maintains the original line groupings of recognized words in its output. Each line comes with bounding box coordinates, and each word within the line also has its own coordinates. If a word was recognized with low confidence, that information is conveyed as well. See the [Read API v2.0 reference docs](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/2afb498089f74080d7ef85eb) or [Read API v3.0 preview reference docs](https://go.microsoft.com/fwlink/?linkid=2118322) to learn more.
+The Read operation maintains the original line groupings of recognized words in its output. Each line comes with bounding box coordinates, and each word within the line also has its own coordinates. If a word was recognized with low confidence, that information is conveyed as well. See the [Read API v2.0 reference docs](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/2afb498089f74080d7ef85eb) or [Read API v3.0 reference docs](https://aka.ms/computer-vision-v3-ref) to learn more.
 
-> [!NOTE]
-> This feature is only available for English and Spanish (v3.0 preview) text.
+The Read operation can recognize text in English, Spanish, German, French, Italian, Portuguese, and Dutch.
 
 ### Image requirements
 

articles/cognitive-services/Computer-vision/language-support.md

@@ -18,38 +18,38 @@ Some features of Computer Vision support multiple languages; any features not me
 
 ## Text recognition
 
-Computer Vision can recognize text in many languages. Specifically, the [OCR](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/56f91f2e778daf14a499e1fc) API supports a variety of languages, whereas the [Read](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/2afb498089f74080d7ef85eb) API and [Recognize Text](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/587f2c6a154055056008f200) API only support English. See [Recognize printed and handwritten text](concept-recognizing-text.md) for more information on this functionality and the advantages of each API.
+Computer Vision can recognize text in many languages.The [OCR](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/56f91f2e778daf14a499e1fc) API  and the [Read](https://aka.ms/computer-vision-v3-ref) API (v3.0) support several languages, and [Recognize Text](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/587f2c6a154055056008f200) API only support English. See [Recognize printed and handwritten text](concept-recognizing-text.md) for more information on this functionality and the advantages of each API.
 
-OCR automatically detects the language of the input material, so there is no need to specify a language code in the API call. However, language codes are always returned as the value of the `"language"` node in the JSON response.
+The OCR and Read APIs automatically detect the language of the input material, so there is no need to specify a language code. Additionally, the language code for the detected language is always returned in the JSON response.
 
-|Language| Language code | OCR API |
-|:-----|:----:|:-----:|
-|Arabic | `ar`|✔ |
-|Chinese (Simplified) | `zh-Hans`|✔ |
-|Chinese (Traditional) | `zh-Hant`|✔ |
-|Czech | `cs` |✔ |
-|Danish | `da` |✔ |
-|Dutch | `nl` |✔ |
-|English | `en` |✔ |
-|Finnish | `fi` |✔ |
-|French | `fr` |✔ |
-|German | `de` |✔ |
-|Greek | `el` |✔ |
-|Hungarian | `hu` |✔ |
-|Italian | `it` |✔ |
-|Japanese | `ja` |✔ |
-|Korean | `ko` |✔ |
-|Norwegian | `nb` |✔ |
-|Polish | `pl` |✔ |
-|Portuguese | `pt` |✔ |
-|Romanian | `ro` |✔ |
-|Russian | `ru` |✔ |
-|Serbian (Cyrillic) | `sr-Cyrl` |✔ |
-|Serbian (Latin) | `sr-Latn` |✔ |
-|Slovak | `sk` |✔ |
-|Spanish | `es` |✔ |
-|Swedish | `sw` |✔ |
-|Turkish | `tr` |✔ |
+|Language| Language code | OCR API | Read API |
+|:-----|:----:|:-----:|:---:|
+|Arabic | `ar`|✔ | |
+|Chinese (Simplified) | `zh-Hans`|✔ | |
+|Chinese (Traditional) | `zh-Hant`|✔ | |
+|Czech | `cs` |✔ | |
+|Danish | `da` |✔ | |
+|Dutch | `nl` |✔ |✔ |
+|English | `en` |✔ |✔ |
+|Finnish | `fi` |✔ | |
+|French | `fr` |✔ |✔ |
+|German | `de` |✔ |✔ |
+|Greek | `el` |✔ | |
+|Hungarian | `hu` |✔ | |
+|Italian | `it` |✔ |✔ |
+|Japanese | `ja` |✔ | |
+|Korean | `ko` |✔ | |
+|Norwegian | `nb` |✔ | |
+|Polish | `pl` |✔ | |
+|Portuguese | `pt` |✔ |✔ |
+|Romanian | `ro` |✔ | |
+|Russian | `ru` |✔ | |
+|Serbian (Cyrillic) | `sr-Cyrl` |✔ | |
+|Serbian (Latin) | `sr-Latn` |✔ | |
+|Slovak | `sk` |✔ | |
+|Spanish | `es` |✔ |✔ |
+|Swedish | `sw` |✔ | |
+|Turkish | `tr` |✔ | |
 
 ## Image analysis
 
@@ -68,4 +68,4 @@ Some actions of the [Analyze - Image](https://westus.dev.cognitive.microsoft.com
 Get started using the Computer Vision features mentioned in this guide.
 
 * [Analyze a local image (REST)](./quickstarts/csharp-analyze.md)
-* [Extract printed text (REST)](./quickstarts/csharp-print-text.md)
+* [Extract printed text (REST)](./quickstarts/csharp-print-text.md)

articles/cognitive-services/Computer-vision/toc.yml

@@ -135,6 +135,8 @@
     href: https://docs.microsoft.com/cli/azure/cognitiveservices?view=azure-cli-latest#az_cognitiveservices_list
   - name: Azure PowerShell
     href: https://aka.ms/azure-powershell-cognitiveservices
+  - name: Computer Vision API v3.0
+    href: https://aka.ms/computer-vision-v3-ref
   - name: Computer Vision API v3.0-preview
     href: https://westus2.dev.cognitive.microsoft.com/docs/services/5d98695995feb7853f67d6a6
   - name: Computer Vision API v2.1

articles/cognitive-services/Speech-Service/how-to-configure-rhel-centos-7.md

@@ -40,7 +40,7 @@ ldconfig -p | grep libstdc++
 
 The output on vanilla RHEL/CentOS 7 (x64) is:
 
-```
+```bash
 libstdc++.so.6 (libc6,x86-64) => /lib64/libstdc++.so.6
 ```
 
@@ -52,7 +52,7 @@ strings /lib64/libstdc++.so.6 | egrep "GLIBCXX_|CXXABI_"
 
 The output should be:
 
-```
+```bash
 ...
 GLIBCXX_3.4.19
 ...
@@ -67,7 +67,11 @@ The Speech SDK requires **CXXABI_1.3.9** and **GLIBCXX_3.4.21**. You can find th
 
 ## Example
 
-This is a sample command that illustrates how to configure RHEL/CentOS 7 x64 for development (C++, C#, Java, Python) with the Speech SDK 1.10.0 or later:
+This is a sample command set that illustrates how to configure RHEL/CentOS 7 x64 for development (C++, C#, Java, Python) with the Speech SDK 1.10.0 or later:
+
+### 1. General setup
+
+First install all general dependencies:
 
 ```bash
 # Only run ONE of the following two commands
@@ -81,16 +85,53 @@ sudo yum update -y
 sudo yum groupinstall -y "Development tools"
 sudo yum install -y alsa-lib dotnet-sdk-2.1 java-1.8.0-openjdk-devel openssl python3
 sudo yum install -y gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly-free
+```
 
-# Build GCC 5.4.0 and runtimes and install them under /usr/local
+### 2. C/C++ compiler and runtime libraries
+
+Install the prerequisite packages with this command:
+
+```bash
 sudo yum install -y gmp-devel mpfr-devel libmpc-devel
+```
+
+> [!NOTE]
+> The libmpc-devel package has been deprecated in the RHEL 7.8 update. If the output of the previous command includes a message
+>
+> ```bash
+> No package libmpc-devel available.
+> ```
+>
+> then the necessary files need to be installed from original sources. Run the following commands:
+>
+> ```bash
+> curl https://ftp.gnu.org/gnu/mpc/mpc-1.1.0.tar.gz -O
+> tar zxf mpc-1.1.0.tar.gz
+> mkdir mpc-1.1.0-build && cd mpc-1.1.0-build
+> ../mpc-1.1.0/configure --prefix=/usr/local --libdir=/usr/local/lib64
+> make -j$(nproc)
+> sudo make install-strip
+> ```
+
+Next update the compiler and runtime libraries:
+
+```bash
+# Build GCC 5.4.0 and runtimes and install them under /usr/local
 curl https://ftp.gnu.org/gnu/gcc/gcc-5.4.0/gcc-5.4.0.tar.bz2 -O
 tar jxf gcc-5.4.0.tar.bz2
 mkdir gcc-5.4.0-build && cd gcc-5.4.0-build
 ../gcc-5.4.0/configure --enable-languages=c,c++ --disable-bootstrap --disable-multilib --prefix=/usr/local
 make -j$(nproc)
 sudo make install-strip
+```
+
+If the updated compiler and libraries need to be deployed on several machines, you can simply copy them from under `/usr/local` to other machines. If only the runtime libraries are needed then the files in `/usr/local/lib64` will be enough.
+
+### 3. Environment settings
 
+Run the following commands to complete the configuration:
+
+```bash
 # Set SSL cert file location
 # (this is required for any development/testing with Speech SDK)
 export SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.crt

articles/cognitive-services/Speech-Service/how-to-use-audio-input-streams.md

@@ -20,14 +20,14 @@ The following steps are required when using audio input streams:
 
 - Identify the format of the audio stream. The format must be supported by the Speech SDK and the Speech service. Currently, only the following configuration is supported:
 
-  Audio samples in PCM format, one channel, 16000 samples per second, 32000 bytes per second, two block align (16 bit including padding for a sample), 16 bits per sample.
+  Audio samples in PCM format, one channel, 16 bits per sample, 8000 or 16000 samples per second (16000 or 32000 bytes per second), two block align (16 bit including padding for a sample).
 
   The corresponding code in the SDK to create the audio format looks like this:
 
   ```csharp
   byte channels = 1;
   byte bitsPerSample = 16;
-  int samplesPerSecond = 16000;
+  int samplesPerSecond = 16000; // or 8000
   var audioFormat = AudioStreamFormat.GetWaveFormatPCM(samplesPerSecond, bitsPerSample, channels);
   ```
 

articles/cognitive-services/Speech-Service/how-to-use-codec-compressed-audio-input-streams.md

@@ -17,7 +17,7 @@ zone_pivot_groups: programming-languages-set-twelve
 
 The Speech service SDK **Compressed Audio Input Stream** API provides a way to stream compressed audio to the Speech service using either a `PullStream` or `PushStream`.
 
-Streaming compressed input audio is currently supported for C#, C++, Java on Windows (UWP applications aren't supported) and Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 8, CentOS 8). It is also supported for Java in Android and Objective-C in iOS platform.
+Streaming compressed input audio is currently supported for C#, C++, Java on Windows (UWP applications aren't supported) and Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8). It is also supported for Java in Android and Objective-C in iOS platform.
 * Speech SDK version 1.10.0 or later is required for RHEL 8 and CentOS 8
 * Speech SDK version 1.11.0 or later is required for for Windows.
 

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-java.md

@@ -8,7 +8,7 @@ ms.author: trbye
 
 :::row:::
     :::column span="3":::
-        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) <span class="docon docon-navigate-external x-hidden-focus"></span></a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.11.0`.
+        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) <span class="docon docon-navigate-external x-hidden-focus"></span></a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.12.0`.
     :::column-end:::
     :::column:::
         <br>
@@ -27,7 +27,7 @@ To consume the package from your Android Studio project, make the following chan
 
 2. In the module-level *build.gradle* file, add the following to the `dependencies` section:
   ```gradle
-  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.11.0'
+  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.12.0'
   ```
 
 The Java SDK is also part of the [Speech Devices SDK](../speech-devices-sdk.md).

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-linux.md

@@ -9,7 +9,6 @@ ms.author: trbye
 :::row:::
     :::column span="3":::
         The Speech SDK only supports **Ubuntu 16.04/18.04**, **Debian 9**, **Red Hat Enterprise Linux (RHEL) 7/8**, and **CentOS 7/8** on the following target architectures when used with Linux:
-        - x64
     :::column-end:::
     :::column:::
         <br>
@@ -19,11 +18,13 @@ ms.author: trbye
     :::column-end:::
 :::row-end:::
 
-> [!IMPORTANT]
-> When targeting Linux ARM64, and using C# - the .NET Core 3.x (dotnet-sdk-3.x package) is required. If you're targeting ARM32 or ARM64, Python is not supported.
+- x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for C++ development
+- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for Java
+- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for .NET Core
+- x64 for Python
 
-> [!NOTE]
-> The x86 architectures of Ubuntu 16.04, Ubuntu 18.04, and Debian 9 only support C++ development with the Speech SDK.
+> [!IMPORTANT]
+> For C# on Linux ARM64, the .NET Core 3.x (dotnet-sdk-3.x package) is required.
 
 ### System requirements
 
@@ -55,10 +56,8 @@ sudo yum install alsa-lib openssl
 ```
 
 > [!IMPORTANT]
-> Follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
-
-> [!TIP]
-> On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](../how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
 
 ---
 

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-macos.md

@@ -38,7 +38,7 @@ platform :ios, '9.3'
 use_frameworks!
 
 target 'MyApp' do
-  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.11.0'
+  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.12.0'
 end
 ```
 

articles/cognitive-services/Speech-Service/includes/how-to/compressed-audio-input/cpp/prerequisites.md

@@ -18,7 +18,7 @@ gstreamer1.0-plugins-bad \
 gstreamer1.0-plugins-ugly
 ```
 
-# [REHL / CentOS](#tab/centos)
+# [RHEL/CentOS 7/8](#tab/centos)
 
 ```sh
 sudo yum install gstreamer1 \
@@ -29,6 +29,10 @@ gstreamer1-plugins-ugly-free
 ```
 
 > [!NOTE]
-> On RHEL / CentOS, follow the instructions on [how to configure OpenSSL for Linux](../../../../how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
+
+> [!IMPORTANT]
+> The Opus audio coding format is not supported by the Speech SDK on RHEL/CentOS 7.
 
 ---