format

Author: ConnorLand

content/en/docs/refguide/mobile/distributing-mobile-apps/pwa-wrapper/pwa-wrapper-troubleshooting.md

@@ -2,7 +2,7 @@
 title: "Troubleshoot PWA Wrapper"
 url: /refguide/mobile/pwa-wrapper/pwa-wrapper-troubleshooting/
 weight: 60
-description: "Known issues and solutions for PWA Wrapper."
+description: "This guide lists known issues for PWA Wrapper, and how to solve them."
 ---
 
 ## Introduction
@@ -13,28 +13,24 @@ This page describes known issues you may encounter when building or testing PWA
 
 ### App Cannot Connect to localhost on a Physical Device{#android-localhost}
 
-**Symptom**: When you set the runtime URL to a localhost address (for example, `http://localhost:8080`) and install the app on a physical Android device, the app fails to load and shows the following error:
+* Symptom — When you set the runtime URL to a localhost address (for example, `http://localhost:8080`) and install the app on a physical Android device, the app fails to load and shows the following error:
 
-```
-Page Load Error
-net::ERR_CACHE_MISS
-```
-
-{{< figure src="/attachments/refguide/mobile/pwa-wrapper/localhost-cache-miss-error.png" alt="Page Load Error showing net::ERR_CACHE_MISS on Android" max-width="400px" >}}
-
-**Cause**: Two things are required for a physical Android device to reach a localhost server on your machine:
+    ```
+    Page Load Error
+    net::ERR_CACHE_MISS
+    ```
 
-1. The app must have the `INTERNET` permission. Without it, the Android OS blocks all outbound network traffic.
-2. The device must have a port forwarding rule from its own localhost to your machine's localhost. Android devices do not forward ports automatically.
+    {{< figure src="/attachments/refguide/mobile/pwa-wrapper/localhost-cache-miss-error.png" alt="Page Load Error showing net::ERR_CACHE_MISS on Android" max-width="400px" >}}
 
-**Solution**:
+* Cause — Two things are required for a physical Android device to reach a localhost server on your machine:
 
-1. In the PWA Wrapper builder, go to the **Permissions** step and enable the **INTERNET** permission.
+    * The app must have the `INTERNET` permission. Without it, the Android OS blocks all outbound network traffic.
+    * The device must have a port forwarding rule from its own localhost to your machine's localhost. Android devices do not forward ports automatically.
 
-    For general guidance on permissions, see [Build PWA Wrapper Apps](/refguide/mobile/distributing-mobile-apps/pwa-wrapper/build-pwa-wrapper-apps/).
+* Solution — To solve this issue, do the following:
 
+1. In the PWA Wrapper builder, go to the **Permissions** step and enable the **INTERNET** permission (for general guidance on permissions, see [Build PWA Wrapper Apps](/refguide/mobile/distributing-mobile-apps/pwa-wrapper/build-pwa-wrapper-apps/).
 1. Connect the Android device to your machine via USB and make sure [USB debugging](https://developer.android.com/studio/debug/dev-options) is enabled on the device.
-
 1. Run the following ADB command to forward port 8080 from the device to your machine:
 
     ```shell
@@ -43,7 +39,7 @@ net::ERR_CACHE_MISS
 
     If your Mendix runtime uses a different port, replace `8080` with the correct port number on both sides.
 
-1. Rebuild and reinstall the app with the localhost runtime URL.
+1. Rebuild and reinstall the app with the **localhost** runtime URL.
 
 The app can now reach the Mendix runtime running on your development machine.