Merge pull request #194976 from PatrickFarley/comvis-updates

[cog svcs] Comvis updates

Author: laurabren

.openpublishing.redirection.json

@@ -36613,6 +36613,11 @@
       "redirect_url": "/azure/cognitive-services/Computer-vision/quickstarts-sdk/csharp-sdk",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/cognitive-services/Computer-vision/Tutorials/CSharpTutorial.md",
+      "redirect_url": "/azure/cognitive-services/Computer-vision/overview-image-analysis",
+      "redirect_document_id": false
+    },
     {
       "source_path_from_root": "/articles/cognitive-services/Content-Moderator/Review-Tool-User-Guide/Upload-Images.md",
       "redirect_url": "/azure/cognitive-services/content-moderator",

articles/cognitive-services/Computer-vision/Tutorials/CSharpTutorial.md

@@ -29,58 +29,55 @@ Use the OCR client library to read printed and handwritten text from a remote im
     * You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
     * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 
-## Setting up
+## Read printed and handwritten text
 
-### Create a new C# application
+1. Create a new C# application.
 
-#### [Visual Studio IDE](#tab/visual-studio)
+    #### [Visual Studio IDE](#tab/visual-studio)
 
-Using Visual Studio, create a new .NET Core application. 
+    Using Visual Studio, create a new .NET Core application. 
 
-### Install the client library 
+    ### Install the client library 
 
-Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Microsoft.Azure.CognitiveServices.Vision.ComputerVision`. Select version `7.0.0`, and then **Install**. 
+    Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Microsoft.Azure.CognitiveServices.Vision.ComputerVision`. Select version `7.0.0`, and then **Install**. 
 
-#### [CLI](#tab/cli)
+    #### [CLI](#tab/cli)
 
-In a console window (such as cmd, PowerShell, or Bash), use the `dotnet new` command to create a new console app with the name `computer-vision-quickstart`. This command creates a simple "Hello World" C# project with a single source file: *Program.cs*.
+    In a console window (such as cmd, PowerShell, or Bash), use the `dotnet new` command to create a new console app with the name `computer-vision-quickstart`. This command creates a simple "Hello World" C# project with a single source file: *Program.cs*.
 
-```console
-dotnet new console -n computer-vision-quickstart
-```
+    ```console
+    dotnet new console -n computer-vision-quickstart
+    ```
 
-Change your directory to the newly created app folder. You can build the application with:
+    Change your directory to the newly created app folder. You can build the application with:
 
-```console
-dotnet build
-```
-
-The build output should contain no warnings or errors. 
-
-```console
-...
-Build succeeded.
- 0 Warning(s)
- 0 Error(s)
-...
-```
+    ```console
+    dotnet build
+    ```
 
-### Install the client library
+    The build output should contain no warnings or errors. 
 
-Within the application directory, install the Computer Vision client library for .NET with the following command:
+    ```console
+    ...
+    Build succeeded.
+     0 Warning(s)
+     0 Error(s)
+    ...
+    ```
 
-```console
-dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --version 7.0.0
-```
+    ### Install the client library
 
----
+    Within the application directory, install the Computer Vision client library for .NET with the following command:
 
-### Find the subscription key and endpoint
+    ```console
+    dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --version 7.0.0
+    ```
 
-[!INCLUDE [find key and endpoint](../find-key.md)]
+    ---
 
+1. Find the subscription key and endpoint.
 
-## Read printed and handwritten text
+    [!INCLUDE [find key and endpoint](../find-key.md)]
 
 1. From the project directory, open the *Program.cs* file in your preferred editor or IDE. Replace the contents of *Program.cs* with the following code.
 
@@ -114,6 +111,33 @@ dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --ver
 
    ---
 
+## Output
+
+```console
+Azure Cognitive Services Computer Vision - .NET quickstart example
+
+----------------------------------------------------------
+READ FILE FROM URL
+
+Extracting text from URL file printed_text.jpg...
+
+
+Nutrition Facts Amount Per Serving
+Serving size: 1 bar (40g)
+Serving Per Package: 4
+Total Fat 13g
+Saturated Fat 1.5g
+Amount Per Serving
+Trans Fat 0g
+Calories 190
+Cholesterol 0mg
+ories from Fat 110
+Sodium 20mg
+nt Daily Values are based on Vitamin A 50%
+calorie diet.
+```
+
+
 ## Clean up resources
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/csharp-sdk.md

@@ -31,57 +31,55 @@ Use the Image Analysis client library for C# to analyze an image for content tag
     * You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
     * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 
-## Setting up
-
-### Create a new C# application
+## Analyze image
 
-#### [Visual Studio IDE](#tab/visual-studio)
+1. Create a new C# application.
 
-Using Visual Studio, create a new .NET Core application. 
+    #### [Visual Studio IDE](#tab/visual-studio)
 
-### Install the client library 
+    Using Visual Studio, create a new .NET Core application. 
 
-Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Microsoft.Azure.CognitiveServices.Vision.ComputerVision`. Select version `7.0.0`, and then **Install**. 
+    ### Install the client library 
 
-#### [CLI](#tab/cli)
+    Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Microsoft.Azure.CognitiveServices.Vision.ComputerVision`. Select version `7.0.0`, and then **Install**. 
 
-In a console window (such as cmd, PowerShell, or Bash), use the `dotnet new` command to create a new console app with the name `computer-vision-quickstart`. This command creates a simple "Hello World" C# project with a single source file: *Program.cs*.
+    #### [CLI](#tab/cli)
 
-```console
-dotnet new console -n computer-vision-quickstart
-```
+    In a console window (such as cmd, PowerShell, or Bash), use the `dotnet new` command to create a new console app with the name `computer-vision-quickstart`. This command creates a simple "Hello World" C# project with a single source file: *Program.cs*.
 
-Change your directory to the newly created app folder. You can build the application with:
+    ```console
+    dotnet new console -n computer-vision-quickstart
+    ```
 
-```console
-dotnet build
-```
+    Change your directory to the newly created app folder. You can build the application with:
 
-The build output should contain no warnings or errors. 
+    ```console
+    dotnet build
+    ```
 
-```console
-...
-Build succeeded.
- 0 Warning(s)
- 0 Error(s)
-...
-```
+    The build output should contain no warnings or errors. 
 
-### Install the client library
+    ```console
+    ...
+    Build succeeded.
+     0 Warning(s)
+     0 Error(s)
+    ...
+    ```
 
-Within the application directory, install the Computer Vision client library for .NET with the following command:
+    ### Install the client library
 
-```console
-dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --version 7.0.0
-```
+    Within the application directory, install the Computer Vision client library for .NET with the following command:
 
----
+    ```console
+    dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --version 7.0.0
+    ```
 
-### Find the subscription key and endpoint
+    ---
 
-[!INCLUDE [find key and endpoint](../find-key.md)]
+1. Find the subscription key and endpoint.
 
-## Analyze image
+    [!INCLUDE [find key and endpoint](../find-key.md)]
 
 1. From the project directory, open the *Program.cs* file in your preferred editor or IDE. Paste in the following code:
 
@@ -108,6 +106,33 @@ dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --ver
 
    ---
 
+## Output
+
+```console
+----------------------------------------------------------
+ANALYZE IMAGE - URL
+
+Analyzing the image sample16.png...
+
+Tags:
+grass 0.9957543611526489
+dog 0.9939157962799072
+mammal 0.9928356409072876
+animal 0.9918001890182495
+dog breed 0.9890419244766235
+pet 0.974603533744812
+outdoor 0.969241738319397
+companion dog 0.906731367111206
+small greek domestic dog 0.8965123891830444
+golden retriever 0.8877675533294678
+labrador retriever 0.8746421337127686
+puppy 0.872604250907898
+ancient dog breeds 0.8508287668228149
+field 0.8017748594284058
+retriever 0.6837497353553772
+brown 0.6581960916519165
+```
+
 ## Clean up resources
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/image-analysis-csharp-sdk.md

@@ -33,61 +33,59 @@ Use the Image Analysis client library to analyze a remote image for tags, text d
     * You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
     * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 
-## Setting up
-
-### Create a new Gradle project
-
-In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app, and navigate to it. 
-
-```console
-mkdir myapp && cd myapp
-```
-
-Run the `gradle init` command from your working directory. This command will create essential build files for Gradle, including *build.gradle.kts*, which is used at runtime to create and configure your application.
+## Analyze image
 
-```console
-gradle init --type basic
-```
+1. Create a new Gradle project.
 
-When prompted to choose a **DSL**, select **Kotlin**.
+    In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app, and navigate to it. 
+    
+    ```console
+    mkdir myapp && cd myapp
+    ```
+    
+    Run the `gradle init` command from your working directory. This command will create essential build files for Gradle, including *build.gradle.kts*, which is used at runtime to create and configure your application.
+    
+    ```console
+    gradle init --type basic
+    ```
 
-### Install the client library
+    When prompted to choose a **DSL**, select **Kotlin**.
 
-This quickstart uses the Gradle dependency manager. You can find the client library and information for other dependency managers on the [Maven Central Repository](https://search.maven.org/artifact/com.microsoft.azure.cognitiveservices/azure-cognitiveservices-computervision).
+1. Install the client library.
 
-Locate *build.gradle.kts* and open it with your preferred IDE or text editor. Then copy in the following build configuration. This configuration defines the project as a Java application whose entry point is the class **ImageAnalysisQuickstart**. It imports the Computer Vision library.
+    This quickstart uses the Gradle dependency manager. You can find the client library and information for other dependency managers on the [Maven Central Repository](https://search.maven.org/artifact/com.microsoft.azure.cognitiveservices/azure-cognitiveservices-computervision).
 
-```kotlin
-plugins {
-    java
-    application
-}
-application { 
-    mainClass.set("ImageAnalysisQuickstart")
-}
-repositories {
-    mavenCentral()
-}
-dependencies {
-    implementation(group = "com.microsoft.azure.cognitiveservices", name = "azure-cognitiveservices-computervision", version = "1.0.6-beta")
-}
-```
+    Locate *build.gradle.kts* and open it with your preferred IDE or text editor. Then copy in the following build configuration. This configuration defines the project as a Java application whose entry point is the class **ImageAnalysisQuickstart**. It imports the Computer Vision library.
 
-### Create a Java file
+    ```kotlin
+    plugins {
+        java
+        application
+    }
+    application { 
+        mainClass.set("ImageAnalysisQuickstart")
+    }
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        implementation(group = "com.microsoft.azure.cognitiveservices", name = "azure-cognitiveservices-computervision", version = "1.0.6-beta")
+    }
+    ```
 
-From your working directory, run the following command to create a project source folder:
+1. Create a Java file.
 
-```console
-mkdir -p src/main/java
-```
+    From your working directory, run the following command to create a project source folder:
 
-Navigate to the new folder and create a file called *ImageAnalysisQuickstart.java*. 
+    ```console
+    mkdir -p src/main/java
+    ```
 
-### Find the subscription key and endpoint
+    Navigate to the new folder and create a file called *ImageAnalysisQuickstart.java*. 
 
-[!INCLUDE [find key and endpoint](../find-key.md)]
+1. Find the subscription key and endpoint.
 
-## Analyze image
+    [!INCLUDE [find key and endpoint](../find-key.md)]
 
 1. Open *ImageAnalysisQuickstart.java* in your preferred editor or IDE and paste in the following code.