edit pass: azure-maps-new-articles-batch

mikematteson · mikematteson · commit 540811a5339e · 2019-04-22T12:40:50.000-07:00
diff --git a/articles/azure-maps/how-to-use-services-module.md b/articles/azure-maps/how-to-use-services-module.md
@@ -18,13 +18,13 @@ The Azure Maps Web SDK provides a *services module*. This module is a helper lib
 
 1. Create a new HTML file.
 1. Load the Azure Maps services module. You can load it in one of two ways:
-    1. Use the globally hosted, Azure Content Delivery Network version of the Azure Maps services module. Add a script reference to the `<head>` element of the file:
+    - Use the globally hosted, Azure Content Delivery Network version of the Azure Maps services module. Add a script reference to the `<head>` element of the file:
 
         ```html
         <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas-service.min.js"></script>
         ```
 
-    1. Alternatively, load the Azure Maps Web SDK source code locally by using the [azure-maps-rest](https://www.npmjs.com/package/azure-maps-rest) npm package, and then host it with your app. This package also includes TypeScript definitions. Use this command:
+    - Alternatively, load the Azure Maps Web SDK source code locally by using the [azure-maps-rest](https://www.npmjs.com/package/azure-maps-rest) npm package, and then host it with your app. This package also includes TypeScript definitions. Use this command:
     
         > **npm install azure-maps-rest**
     
@@ -58,7 +58,7 @@ The Azure Maps Web SDK provides a *services module*. This module is a helper lib
 
     ```javascript
     // Enter your Azure AD client ID.
-    var clientId = "<Your Azure Active Directory client ID>";
+    var clientId = "<Your Azure Active Directory Client Id>";
 
     // Use TokenCredential with OAuth token (Azure AD or Anonymous).
     var aadToken = await getAadToken();
@@ -177,7 +177,7 @@ Learn more about the classes and methods used in this article:
 > [!div class="nextstepaction"]
 > [TokenCredential](https://docs.microsoft.com/javascript/api/azure-maps-rest/atlas.service.tokencredential?view=azure-iot-typescript-latest)
 
-See the following articles for more code samples that use the services module:
+For more code samples that use the services module, see these articles:
 
 > [!div class="nextstepaction"]
 > [Show search results on the map](./map-search-location.md)
diff --git a/articles/azure-maps/supported-browsers.md b/articles/azure-maps/supported-browsers.md
@@ -12,43 +12,43 @@ manager: cpendleton
 
 # Web SDK supported browsers
 
-The Azure Maps Web SDK provides a helper function [atlas.isSupported](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas?view=azure-iot-typescript-latest#issupported-boolean-) to detect if a web browser has the minimum required WebGL features to support loading and rendering the map control.
+The Azure Maps Web SDK provides a helper function called [atlas.isSupported](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas?view=azure-iot-typescript-latest#issupported-boolean-). This function detects whether a web browser has the minimum set of WebGL features required to support loading and rendering the map control. Here's an example of how to use the function:
 
 ```
 if(!atlas.isSupported()) {
     alert('Your browser is not supported by Azure Maps');
 } else if(!atlas.isSupported(true)) {
     alert('Your browser is supported by Azure Maps, but may have major performance caveats.');
 } else {
-    //Your browser is supported. Add your map code here.
+    // Your browser is supported. Add your map code here.
 }
 ```
 
 ## Desktop
 
-The Azure Maps Web SDK supports the following desktop browsers.
+The Azure Maps Web SDK supports the following desktop browsers:
 
-- The current and previous version of Microsoft Edge 
-- The current and previous version of Chrome 
-- The current and previous version of Firefox 
-- The current and previous version of Safari (Mac OS X) 
+- Microsoft Edge (current and previous version)
+- Google Chrome (current and previous version)
+- Mozilla Firefox  (current and previous version)
+- Apple Safari (Mac OS X) (current and previous version)
 
-See also [Target legacy browsers](#Target-Legacy-Browsers).
+See also [Target legacy browsers](#Target-Legacy-Browsers) later in this article.
 
 ## Mobile
 
-The Azure Maps Web SDK supports the following mobile browsers.
+The Azure Maps Web SDK supports the following mobile browsers:
 
--  Android
-    * Current version of Chrome on Android 6.0+
-    * Chrome WebView on Android 6.0+
+- Android
+  - Current version of Chrome on Android 6.0 and later
+  - Chrome WebView on Android 6.0 and later
 - iOS
-    * Mobile Safari on the current and previous major version of iOS
-    * UIWebView and WKWebView on the current and previous major version of iOS
-    * Current version of Chrome for iOS
+  - Mobile Safari on the current and previous major version of iOS
+  - UIWebView and WKWebView on the current and previous major version of iOS
+  - Current version of Chrome for iOS
 
 > [!TIP]
-> If you are embedding a map inside a mobile application using a WebView control, you may prefer using the [npm package of the Azure Maps Web SDK](https://www.npmjs.com/package/azure-maps-control) instead of referencing the CDN hosted version of the SDK. This will reduce loading time as the SDK will already be on the user's device and not need to be downloaded at runtime.
+> If you're embedding a map inside a mobile application by using a WebView control, you might prefer to use the [npm package of the Azure Maps Web SDK](https://www.npmjs.com/package/azure-maps-control) instead of referencing the version of the SDK that's hosted on Azure Content Delivery Network. This approach reduces loading time because the SDK is already be on the user's device and doesn't need to be downloaded at run time.
 
 ## Node.js
 
@@ -58,7 +58,7 @@ The following Web SDK modules are also supported in Node.js:
 
 ## <a name="Target-Legacy-Browsers"></a>Target legacy browsers
 
-If you need to target older browsers that may not support or have limited support for WebGL, it is recommended to use the Azure Maps Services in combination with an open-source map control such as [leaflet](https://leafletjs.com/). 
+You might want to target older browsers that don't support WebGL or that have only limited support for it. In such cases, we recommend that you use Azure Maps services together with an open-source map control like [Leaflet](https://leafletjs.com/). Here's an example:
 
 
 <iframe height="500" style="width: 100%;" scrolling="no" title="Azure Maps + Leaflet" src="//codepen.io/azuremaps/embed/GeLgyx/?height=500&theme-id=0&default-tab=html,result" frameborder="no" allowtransparency="true" allowfullscreen="true">
