Merge pull request #107868 from stevemunk/drawing-error-visualizer

Error Drawing Visualizer - Grammatical improvements

Author: ShannonLeavitt

articles/azure-maps/drawing-error-visualizer.md

@@ -1,6 +1,6 @@
 ---
 title: Use Azure Maps Drawing Error Visualizer
-description: In this article, you'll learn about how to visualize warnings and errors returned by the Creator Conversion API.
+description: This article demonstrates how to visualize warnings and errors returned by the Creator Conversion API.
 author: eriklindeman
 ms.author: eriklind
 ms.date: 02/17/2023
@@ -12,21 +12,21 @@ services: azure-maps
 
 # Using the Azure Maps Drawing Error Visualizer with Creator
 
-The Drawing Error Visualizer is a stand-alone web application that displays [Drawing package warnings and errors](drawing-conversion-error-codes.md) detected during the conversion process. The Error Visualizer web application consists of a static page that you can use without connecting to the internet.  You can use the Error Visualizer to fix errors and warnings in accordance with [Drawing package requirements](drawing-requirements.md). The [Azure Maps Conversion API](/rest/api/maps/v2/conversion) returns a response with a link to the Error Visualizer only when an error is detected.
+The *Drawing Error Visualizer* is a stand-alone web application that displays [Drawing package warnings and errors] detected during the conversion process. The Error Visualizer web application consists of a static page that you can use without connecting to the internet.  You can use the Error Visualizer to fix errors and warnings in accordance with [Drawing package requirements]. The [Azure Maps Conversion API] returns a response with a link to the Error Visualizer only when an error is detected.
 
 ## Prerequisites
 
 * An [Azure Maps account]
 * A [subscription key]
 * A [Creator resource]
 
-This tutorial uses the [Postman](https://www.postman.com/) application, but you may choose a different API development environment.
+This tutorial uses the [Postman] application, but you may choose a different API development environment.
 
 ## Download
 
-1. Upload your drawing package to the Azure Maps Creator service to obtain a `udid` for the uploaded package. For steps on how to upload a package, see [Upload a drawing package](tutorial-creator-indoor-maps.md#upload-a-drawing-package).
+1. Upload your drawing package to the Azure Maps Creator service to obtain a `udid` for the uploaded package. For steps on how to upload a package, see [Upload a drawing package].
 
-2. Now that the drawing package is uploaded, we'll use `udid` for the uploaded package to convert the package into map data. For steps on how to convert a package, see [Convert a drawing package](tutorial-creator-indoor-maps.md#convert-a-drawing-package).
+2. Now that the drawing package is uploaded, use `udid` for the uploaded package to convert the package into map data. For steps on how to convert a package, see [Convert a drawing package].
 
     >[!NOTE]
     >If your conversion process succeeds, you will not receive a link to the Error Visualizer tool.
@@ -48,7 +48,7 @@ This tutorial uses the [Postman](https://www.postman.com/) application, but you
 
 ## Setup
 
-Inside the downloaded zipped package from the `diagnosticPackageLocation` link, you'll find two files.
+The downloaded zipped package from the `diagnosticPackageLocation` link contains the following two files.
 
 * _VisualizationTool.zip_: Contains the source code, media, and web page for the Drawing Error Visualizer.
 * _ConversionWarningsAndErrors.json_: Contains a formatted list of warnings, errors, and other details that are used by the Drawing Error Visualizer.
@@ -59,7 +59,7 @@ Unzip the _VisualizationTool.zip_ folder. It contains the following items:
 * _static_ folder: source code
 * _index.html_ file: the web application.
 
-Open the _index.html_ file using any of the browsers below, with the respective version number. You may use a different version, if the version offers equally compatible behavior as the listed version.
+Open the _index.html_ file using any of the following browsers, with the respective version number. You may use a different version, if the version offers equally compatible behavior as the listed version.
 
 * Microsoft Edge 80
 * Safari 13
@@ -72,11 +72,11 @@ After launching the Drawing Error Visualizer tool, you'll be presented with the
 
 :::image type="content" source="./media/drawing-errors-visualizer/start-page.png" alt-text="Drawing Error Visualizer App - Start Page":::
 
-The  _ConversionWarningsAndErrors.json_ file has been placed at the root of the downloaded directory. To load the _ConversionWarningsAndErrors.json_, drag & drop the file onto the box. Or, click on the box, find the file in the `File Explorer dialogue`, and upload the file.
+The  _ConversionWarningsAndErrors.json_ file has been placed at the root of the downloaded directory. To load the _ConversionWarningsAndErrors.json_, drag & drop the file onto the box. Or, select on the box, find the file in the `File Explorer dialogue`, and upload the file.
 
 :::image type="content" source="./media/drawing-errors-visualizer/loading-data.gif" alt-text="Drawing Error Visualizer App - Drag and drop to load data":::
 
-Once the _ConversionWarningsAndErrors.json_ file loads, you'll see a list of your drawing package errors and warnings. Each error or warning is specified by the layer, level, and a detailed message. To view detailed information about an error or warning, click on the **Details** link. An intractable section will then appear below the list. You may now navigate to each error to learn more details on how to resolve the error.
+The _ConversionWarningsAndErrors.json_ contains a list of your drawing package errors and warnings. To view detailed information about an error or warning, select the **Details** link. An intractable section appears below the list. You may now navigate to each error to learn more details on how to resolve the error.
 
 :::image type="content" source="./media/drawing-errors-visualizer/errors.png" alt-text="Drawing Error Visualizer App - Errors and Warnings":::
 
@@ -85,8 +85,15 @@ Once the _ConversionWarningsAndErrors.json_ file loads, you'll see a list of you
 Learn more by reading:
 
 > [!div class="nextstepaction"]
-> [Creator for indoor maps](creator-indoor-maps.md)
+> [Creator for indoor maps]
 
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
+[Azure Maps Conversion API]: /rest/api/maps/v2/conversion
+[Convert a drawing package]: tutorial-creator-indoor-maps.md#convert-a-drawing-package
+[Creator for indoor maps]: creator-indoor-maps.md
+[Creator resource]: how-to-manage-creator.md
+[Drawing package requirements]: drawing-requirements.md
+[Drawing package warnings and errors]: drawing-conversion-error-codes.md
+[Postman]: https://www.postman.com/
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
-[Creator resource]: how-to-manage-creator.md
+[Upload a drawing package]: tutorial-creator-indoor-maps.md#upload-a-drawing-package