Merge pull request #112471 from stevemunk/quick-android-map

Minor grammatical changes to article: Quickstart: Create an Android app with Azure Maps.

Author: Jak-MS

articles/azure-maps/quick-android-map.md

@@ -24,9 +24,9 @@ This article shows you how to add the Azure Maps to an Android app. It walks you
 
 ## Prerequisites
 
-1. A subscription to [Microsoft Azure](https://azure.microsoft.com). If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
+1. A subscription to [Microsoft Azure]. If you don't have an Azure subscription, [create a free account] before you begin.
 
-1. [Android Studio](https://developer.android.com/studio/). If you don't have Android Studio, you can get it for free from Google.
+1. [Android Studio]. If you don't have Android Studio, you can get it for free from Google.
 
 > [!NOTE]
 > Many of the instructions in this quickstart were created using Android Studio Arctic Fox (2020.3.1). If you use a different version of Android Studio, the steps specific to Android Studio may vary.
@@ -35,7 +35,7 @@ This article shows you how to add the Azure Maps to an Android app. It walks you
 
 Create a new Azure Maps account using the following steps:
 
-1. In the upper left-hand corner of the [Azure portal](https://portal.azure.com), select **Create a resource**.
+1. In the upper left-hand corner of the [Azure portal], select **Create a resource**.
 2. In the *Search the Marketplace* box, type **Azure Maps**, then select **Azure Maps** from the search results.
 3. Select the **Create** button.
 4. On the **Create Maps Account** page, enter the following values:
@@ -58,7 +58,7 @@ Once your Azure Maps account is successfully created, retrieve the subscription
 3. Copy the **Primary Key** and save it locally to use later in this tutorial.
 
 >[!NOTE]
-> For security purposes, it is recommended that you rotate between your primary and secondary keys. To rotate keys, update your app to use the secondary key, deploy, then press the cycle/refresh button beside the primary key to generate a new primary key. The old primary key will be disabled. For more information on key rotation, see [Set up Azure Key Vault with key rotation and auditing](../key-vault/secrets/tutorial-rotation-dual.md)
+> For security purposes, it is recommended that you rotate between your primary and secondary keys. To rotate keys, update your app to use the secondary key, deploy, then press the cycle/refresh button beside the primary key to generate a new primary key. The old primary key will be disabled. For more information on key rotation, see [Set up Azure Key Vault with key rotation and auditing].
 
 :::image type="content" source="./media/quick-android-map/get-key.png" alt-text="A screenshot showing the Azure Maps Primary key in the Azure portal.":::
 
@@ -76,15 +76,15 @@ Complete the following steps to create a new project with an empty activity in A
 
     :::image type="content" source="./media/quick-android-map/3-empty-activity.png" alt-text="A screenshot that shows the Create an Empty Activity screen in Android Studio.":::
 
-1. In the **Empty Activity** screen you'll need to enter values for the following fields:
+1. In the **Empty Activity** screen, enter values for the following fields:
     * **Name**. Enter **AzureMapsApp**.
     * **Package name**. Use the default **com.example.azuremapsapp**.
     * **Save location**. Use the default or select a new location to save your project files. Avoid using spaces in the path or filename due to potential problems with the NDK tools.
     * **Language**. Select Kotlin or Java.
     * **Minimum SDK**. Select `API 21: Android 5.0.0 (Lollipop)` as the minimum SDK. It's the earliest version supported by the Azure Maps Android SDK.
 1. Select **Finish** to create your new project.
 
-See the [Android Studio documentation](https://developer.android.com/studio/intro/) for more help with installing Android Studio and creating a new project.
+See the [Android Studio documentation] for more help with installing Android Studio and creating a new project.
 
 ## Set up a virtual device
 
@@ -96,7 +96,7 @@ To set up an Android Virtual Device (AVD):
 1. The **Android Virtual Device Manager** appears. Select **Create Virtual Device**.
 1. In the **Phones** category, select **Nexus 5X**, and then select **Next**.
 
-You can learn more about setting up an AVD in the [Android Studio documentation](https://developer.android.com/studio/run/managing-avds).
+For more information about setting up an AVD, see [Create and manage virtual devices] in the Android Studio documentation.
 
 :::image type="content" source="./media/quick-android-map/4-avd-select-hardware.png" alt-text="A screenshot that shows the Select Hardware screen in Android Virtual Device Manager when creating a new Virtual Device.":::
 
@@ -121,14 +121,13 @@ The next step in building your application is to install the Azure Maps Android
    :::image type="content" source="./media/quick-android-map/project-settings-file.png" alt-text="A screenshot of the project settings file in Android Studio.":::
 
 3. Open the project's **gradle.properties** file, verify that `android.useAndroidX` and `android.enableJetifier` are both set to `true`.
-   
+
    If the **gradle.properties** file doesn't include `android.useAndroidX` and `android.enableJetifier`, add the next two lines to the end of the file:
-   
+
    ```gradle
    android.useAndroidX=true
    android.enableJetifier=true
    ```
-   
 
 4. Open the application **build.gradle** file and do the following:
 
@@ -169,7 +168,7 @@ The next step in building your application is to install the Azure Maps Android
 
 ::: zone pivot="programming-language-java-android"
 
-6. In the **MainActivity.java** file you'll need to:
+6. In the **MainActivity.java** file:
 
     * Add imports for the Azure Maps SDK.
     * Set your Azure Maps authentication information.
@@ -277,7 +276,7 @@ The next step in building your application is to install the Azure Maps Android
 
 ::: zone pivot="programming-language-kotlin"
 
-7. In the **MainActivity.kt** file you'll need to:
+7. In the **MainActivity.kt** file:
 
     * add imports for the Azure Maps SDK
     * set your Azure Maps authentication information
@@ -397,7 +396,7 @@ Android Studio takes a few seconds to build the application. After the build is
 ## Clean up resources
 
 >[!WARNING]
-> The tutorials listed in the [Next Steps](#next-steps) section detail how to use and configure Azure Maps with your account. Don't clean up the resources created in this quickstart if you plan to continue to the tutorials.
+> The tutorials listed in the [Next Steps] section detail how to use and configure Azure Maps with your account. Don't clean up the resources created in this quickstart if you plan to continue to the tutorials.
 
 If you don't plan to continue to the tutorials, take these steps to clean up the resources:
 
@@ -412,15 +411,30 @@ If you don't plan on continuing to develop with the Azure Maps Android SDK:
 
 For more code examples, see these guides:
 
-* [Manage authentication in Azure Maps](how-to-manage-authentication.md)
-* [Change map styles in Android maps](set-android-map-styles.md)
-* [Add a symbol layer](how-to-add-symbol-to-android-map.md)
-* [Add a line layer](android-map-add-line-layer.md)
-* [Add a polygon layer](how-to-add-shapes-to-android-map.md)
+* [Manage authentication in Azure Maps]
+* [Change map styles in Android maps]
+* [Add a symbol layer]
+* [Add a line layer]
+* [Add a polygon layer]
 
 ## Next steps
 
 In this quickstart, you created your Azure Maps account and created a demo application. Take a look at the following tutorial to learn more about Azure Maps:
 
 > [!div class="nextstepaction"]
-> [Load GeoJSON data into Azure Maps](tutorial-load-geojson-file-android.md)
+> [Tutorial: Load GeoJSON data into Azure Maps Android SDK]
+
+[Add a line layer]: android-map-add-line-layer.md
+[Add a polygon layer]: how-to-add-shapes-to-android-map.md
+[Add a symbol layer]: how-to-add-symbol-to-android-map.md
+[Android Studio documentation]: https://developer.android.com/studio/intro
+[Android Studio]: https://developer.android.com/studio
+[Azure portal]: https://portal.azure.com
+[Change map styles in Android maps]: set-android-map-styles.md
+[create a free account]: https://azure.microsoft.com/free
+[Create and manage virtual devices]: https://developer.android.com/studio/run/managing-avds
+[Manage authentication in Azure Maps]: how-to-manage-authentication.md
+[Microsoft Azure]: https://azure.microsoft.com
+[Next Steps]: #next-steps
+[Set up Azure Key Vault with key rotation and auditing]: ../key-vault/secrets/tutorial-rotation-dual.md
+[Tutorial: Load GeoJSON data into Azure Maps Android SDK]: tutorial-load-geojson-file-android.md