add docs for vpp to fma apps

articles/fleet-maintained-apps.md

@@ -73,6 +73,17 @@ To manage Fleet-maintained apps using Fleet's best practice GitOps, check out `f
 
 > Note: with GitOps enabled, any Fleet-maintained apps added using the web UI will not persist if not also added in YAML.
 
+## Migrate from Apple VPP to Fleet-maintained apps
+
+If you're currently using Apple App Store (VPP) apps and want to switch to Fleet-maintained apps, follow these steps:
+
+1. In Fleet, head to the **Software** page and select the relevant fleet.
+2. Remove the VPP app you want to replace.
+3. Add the same app from the Fleet-maintained apps list (see [Add a Fleet-maintained app](#add-a-fleet-maintained-app) above).
+4. Install the Fleet-maintained app via one of the three methods above.
+
+> **Important:** VPP apps are sandboxed by macOS, which means their preferences and application state are stored in a different location than non-VPP apps. For example, Slack's preferences are stored at `~/Library/Containers/com.tinyspeck.slackmacgap/Data/Library/Preferences/` for VPP, vs. `~/Library/Preferences/` for a regular install. When you replace a VPP app with a Fleet-maintained app, end users may need to reconfigure their app preferences and settings. Plan to communicate this to your end users before making the switch.
+
 ## How does Fleet maintain these apps?
 
 Fleet:

articles/install-app-store-apps.md

@@ -59,7 +59,7 @@ You can also manage which Google Play Store apps are available for self-service
 Apps can be installed manually on each host's **Host details** page. For macOS apps, apps can also be installed via self-service on the end user's **Fleet Desktop > My device** page or [automatically via policy automation](https://fleetdm.com/guides/automatic-software-install-in-fleet).
 
 > If the install fails with `ErrorCode` 301 and a `LocalizedDescription` of "Invalid Status Code The response has an invalid status code" it may be because the app has a minimum OS version higher than what the targeted host is running.
-> 
+>
 > To find the minimum OS version for the app, visit the [App Store](https://apps.apple.com/), find the app, scroll to the bottom, and look for **Compatibility** under **Information**.
 
 Currently, Apple App Store (VPP) apps can't be uninstalled via Fleet. If the app is uninstalled by the end user, or when the host is unenrolled, the license won't be revoked. You can revoke the license by running [this script](https://github.com/fleetdm/fleet/blob/main/docs/solutions/macos/scripts/revoke-vpp-licenses.sh).
@@ -86,7 +86,7 @@ This configuration makes it so the end user won't have to type the portal hostna
   "managedConfiguration": {
     "portal": "example.portal.com",
     "connect_method": "on-demand"
-  }  
+  }
 }
 
 ```
@@ -103,6 +103,17 @@ This configuration allows end users to add widgets from the Google Calendar in t
 }
 ```
 
+## Migrate from Apple VPP to Fleet-maintained apps
+
+If you're currently using VPP apps and want to switch to [Fleet-maintained apps](https://fleetdm.com/guides/fleet-maintained-apps), follow these steps:
+
+1. In Fleet, head to the **Software** page and select the relevant fleet.
+2. Remove the VPP app you want to replace.
+3. Add the same app from the Fleet-maintained apps list.
+4. Install the Fleet-maintained app on your hosts.
+
+> **Important:** VPP apps are sandboxed by macOS, which means their preferences and application state are stored in a different location than non-VPP apps. For example, Slack's preferences are stored at `~/Library/Containers/com.tinyspeck.slackmacgap/Data/Library/Preferences/` for VPP, vs. `~/Library/Preferences/` for a regular install. When you replace a VPP app with a Fleet-maintained app, end users may need to reconfigure their app preferences and settings. Plan to communicate this to your end users before making the switch.
+
 ## API and GitOps
 
 Fleet also provides a REST API for managing app store apps programmatically. Learn more in the API [reference docs](https://fleetdm.com/docs/rest-api/rest-api#add-app-store-app).