Merge pull request #111602 from stevemunk/how-to-use-spatial-io-module-grammar-links

Improved grammar and changed inline links to end links in 'How to use the Azure Maps Spatial IO module'

Author: ShannonLeavitt

articles/azure-maps/how-to-use-spatial-io-module.md

@@ -1,6 +1,6 @@
 ---
 title: How to use the Azure Maps spatial IO module | Microsoft Azure Maps
-description: Learn how to use the Spatial IO module provided by the Azure Maps Web SDK. This module provides robust features to make it easy for developers to integrate spatial data with the Azure Maps web sdk.
+description: Learn how to use the Spatial IO module provided by the Azure Maps Web SDK. This module provides robust features to make it easy for developers to integrate spatial data with the Azure Maps web SDK.
 author: eriklindeman
 ms.author: eriklind
 ms.date: 02/28/2020
@@ -15,13 +15,13 @@ ms.custom:
 
 The Azure Maps Web SDK provides the **Spatial IO module**, which integrates spatial data with the Azure Maps web SDK using JavaScript or TypeScript. The robust features in this module allow developers to:
 
-- [Read and write common spatial data files](spatial-io-read-write-spatial-data.md). Supported file formats include: KML, KMZ, GPX, GeoRSS, GML, GeoJSON and CSV files containing columns with spatial information. Also supports Well-Known Text (WKT).
-- [Connect to Open Geospatial Consortium (OGC) services and integrate with Azure Maps web SDK. Overlay Web Map Services (WMS) and Web Map Tile Services (WMTS) as layers on the map](spatial-io-add-ogc-map-layer.md).
-- [Query data in a Web Feature Service (WFS)](spatial-io-connect-wfs-service.md).
-- [Overlay complex data sets that contain style information and have them render automatically using minimal code](spatial-io-add-simple-data-layer.md).
-- [Leverage high-speed XML and delimited file reader and writer classes](spatial-io-core-operations.md).
+- [Read and write spatial data]. Supported file formats include: KML, KMZ, GPX, GeoRSS, GML, GeoJSON and CSV files containing columns with spatial information. Also supports Well-Known Text (WKT).
+- Connect to Open Geospatial Consortium (OGC) services and integrate with Azure Maps web SDK, and overlay Web Map Services (WMS) and Web Map Tile Services (WMTS) as layers on the map. For more information, see [Add a map layer from the Open Geospatial Consortium (OGC)].
+- Query data in a Web Feature Service (WFS). For more information, see [Connect to a WFS service].
+- Overlay complex data sets that contain style information and have them render automatically. For more information, see [Add a simple data layer].
+- Leverage high-speed XML and delimited file reader and writer classes. For more information, see [Core IO operations].
 
-In this guide, we'll learn how to integrate and use the Spatial IO module in a web application.
+This guide demonstrates how to integrate and use the Spatial IO module in a web application.
 
 This video provides an overview of Spatial IO module in the Azure Maps Web SDK.
 
@@ -30,24 +30,24 @@ This video provides an overview of Spatial IO module in the Azure Maps Web SDK.
 > [!VIDEO https://learn.microsoft.com/Shows/Internet-of-Things-Show/Easily-integrate-spatial-data-into-the-Azure-Maps/player?format=ny]
 
 > [!WARNING]
-> Only use data and services that are from a source you trust, especially if referencing it from another domain. The spatial IO module does take steps to minimize risk, however the safest approach is too not allow any danagerous data into your application to begin with. 
+> Only use data and services that are from a source you trust, especially if referencing it from another domain. The spatial IO module does take steps to minimize risk, however the safest approach is too not allow any dangerous data into your application to begin with.
 
 ## Prerequisites
 
-* An [Azure Maps account]
-* A [subscription key]
+- An [Azure Maps account]
+- A [subscription key]
 
 ## Installing the Spatial IO module
 
 You can load the Azure Maps spatial IO module using one of the two options:
 
-* The globally hosted Azure CDN for the Azure Maps spatial IO module. For this option, you add a reference to the JavaScript in the `<head>` element of the HTML file.
+- The globally hosted Azure CDN for the Azure Maps spatial IO module. For this option, you add a reference to the JavaScript in the `<head>` element of the HTML file.
 
     ```html
     <script src="https://atlas.microsoft.com/sdk/javascript/spatial/0/atlas-spatial.js"></script>
     ```
 
-* The source code for [azure-maps-spatial-io](https://www.npmjs.com/package/azure-maps-spatial-io) can be loaded locally, and then hosted with your app. This package also includes TypeScript definitions. For this option, use the following command to install the package:
+- The source code for [azure-maps-spatial-io] can be loaded locally, and then hosted with your app. This package also includes TypeScript definitions. For this option, use the following command to install the package:
 
     ```sh
     npm install azure-maps-spatial-io
@@ -63,7 +63,7 @@ You can load the Azure Maps spatial IO module using one of the two options:
 
 1. Create a new HTML file.
 
-2. Load the Azure Maps Web SDK and initialize the map control. See the [Azure Maps map control](./how-to-use-map-control.md) guide for the details. Once you're done with this step, your HTML file should look like this:
+1. Load the Azure Maps Web SDK and initialize the map control. See the [Azure Maps map control] guide for the details. Once you're done with this step, your HTML file should look like this:
 
     ```html
     <!DOCTYPE html>
@@ -117,13 +117,13 @@ You can load the Azure Maps spatial IO module using one of the two options:
     </html>
     ```
 
-2. Load the Azure Maps spatial IO module. For this exercise, use the CDN for the Azure Maps spatial IO module. Add the reference below to the `<head>` element of your HTML file:
+1. Load the Azure Maps spatial IO module. For this exercise, use the CDN for the Azure Maps spatial IO module. Add the following reference to the `<head>` element of your HTML file:
 
     ```html
     <script src="https://atlas.microsoft.com/sdk/javascript/spatial/0/atlas-spatial.js"></script>
     ```
 
-3. Initialize a `datasource`, and add the data source to the map. Initialize a `layer`, and add the data source to the map layer. Then, render both the data source and the layer. Before you scroll down to see the full code in the next step, think about the best places to put the data source and layer code snippets. Recall that, before we programmatically manipulate the map, we should wait until the map resource are ready.
+1. Initialize a `datasource`, and add the data source to the map. Initialize a `layer`, and add the data source to the map layer. Then, render both the data source and the layer. Before you scroll down to see the full code in the next step, think about the best places to put the data source and layer code snippets. Recall that, before we programmatically manipulate the map, we should wait until the map resource are ready.
 
     ```javascript
     var datasource, layer;
@@ -141,7 +141,7 @@ You can load the Azure Maps spatial IO module using one of the two options:
     map.layers.add(layer);
     ```
 
-4. Putting it all together, your HTML code should look like the following code. This sample demonstrates how to read an XML file from a URL. Then, load and display the file's feature data on the map. 
+1. Your HTML code should now look like the following code. This sample demonstrates how to read an XML file from a URL. Then, load and display the file's feature data on the map.
 
     ```html
     <!DOCTYPE html>
@@ -218,7 +218,7 @@ You can load the Azure Maps spatial IO module using one of the two options:
     </html>
     ```
 
-5. Remember to replace `<Your Azure Maps Key>` with your subscription key. Open your HTML file, and you'll see results similar to the following image:
+1. Remember to replace `<Your Azure Maps Key>` with your subscription key. You should see results similar to the following image in your HTML file:
 
     <center>
 
@@ -228,30 +228,41 @@ You can load the Azure Maps spatial IO module using one of the two options:
 
 ## Next steps
 
-The feature we demonstrated here is only one of the many features available in the Spatial IO module. Read the guides below to learn how to use other functionalities in the Spatial IO module:
+The feature we demonstrated is only one of the many features available in the Spatial IO module. Read the following guides to learn how to use other functionalities in the Spatial IO module:
 
 > [!div class="nextstepaction"]
-> [Add a simple data layer](spatial-io-add-simple-data-layer.md)
+> [Add a simple data layer]
 
 > [!div class="nextstepaction"]
-> [Read and write spatial data](spatial-io-read-write-spatial-data.md)
+> [Read and write spatial data]
 
 > [!div class="nextstepaction"]
-> [Add an OGC map layer](spatial-io-add-ogc-map-layer.md)
+> [Add an OGC map layer]
 
 > [!div class="nextstepaction"]
-> [Connect to a WFS service](spatial-io-connect-wfs-service.md)
+> [Connect to a WFS service]
 
 > [!div class="nextstepaction"]
-> [Leverage core operations](spatial-io-core-operations.md)
+> [Leverage core operations]
 
 > [!div class="nextstepaction"]
-> [Supported data format details](spatial-io-supported-data-format-details.md)
+> [Supported data format details]
 
 Refer to the Azure Maps Spatial IO documentation:
 
 > [!div class="nextstepaction"]
-> [Azure Maps Spatial IO package](/javascript/api/azure-maps-spatial-io/)
+> [Azure Maps Spatial IO package]
 
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
+[Read and write spatial data]: spatial-io-read-write-spatial-data.md
+[Add a map layer from the Open Geospatial Consortium (OGC)]: spatial-io-add-ogc-map-layer.md
+[Add a simple data layer]: spatial-io-add-simple-data-layer.md
+[Core IO operations]: spatial-io-core-operations.md
+[Connect to a WFS service]: spatial-io-connect-wfs-service.md
+[azure-maps-spatial-io]: https://www.npmjs.com/package/azure-maps-spatial-io
+[Azure Maps map control]: how-to-use-map-control.md
+[Add an OGC map layer]: spatial-io-add-ogc-map-layer.md
+[Leverage core operations]: spatial-io-core-operations.md
+[Supported data format details]: spatial-io-supported-data-format-details.md
+[Azure Maps Spatial IO package]: /javascript/api/azure-maps-spatial-io