Merged PR 22140: Bringing these docs up to date.

Bringing these docs up to date.

Author: Steve White

windows.applicationmodel/package_effectiveexternallocation.md

@@ -34,4 +34,3 @@ To set the external folder, use one of the following combinations of [PackageMan
 [AddPackageByUriAsync](../windows.management.deployment/packagemanager_addpackagebyuriasync_797417417.md),[RegisterPackageByUriAsync](../windows.management.deployment/packagemanager_registerpackagebyuriasync_1415074502.md),[StagePackageByUriAsync](../windows.management.deployment/packagemanager_stagepackagebyuriasync_446584280.md)
 
 ## -examples
-

windows.applicationmodel/package_effectivelocation.md

@@ -12,19 +12,18 @@ public StorageFolder EffectiveLocation { get; }
 
 ## -description
 
-Gets either the location of the installed folder or the mutable folder for the installed package, depending on whether the app is declared to be mutable in its package manifest.
+Gets the effective location for the installed package, depending on how the app is declared in its package manifest. For details, see **Remarks**.
 
 ## -property-value
 
-The location of the installed folder or the mutable folder for the installed package, depending on whether the app is declared to be mutable in its package manifest.
+The effective location for the installed package, depending on how the app is declared in its package manifest. For details, see **Remarks**.
 
 ## -remarks
 
-If the app is declared to be mutable by including the [windows.mutablePackageDirectories extension](/uwp/schemas/appxpackage/uapmanifestschema/element-desktop6-package-extension) in its package manifest, this property gets the mutable folder for the installed package (that is, the folder under C:\Program Files\ModifiableWindowsApps where users can add files that modify the app). If the app is not declared to be mutable, this property gets the same value as the [InstalledLocation](package_installedlocation.md) property. The mutable folder feature is currently available only for certain types of desktop PC games that are published by Microsoft and our partners, and it enables these types of games to support mods.
+If the package has a User-External location, then get that folder. Otherwise, if the package has a Machine-External location, then get that folder. Otherwise, if the package has a [Mutable location](/uwp/schemas/appxpackage/uapmanifestschema/element-desktop8-mutablepackagedirectories), then get the Mutable folder for the installed package (that is, the folder under `C:\Program Files\ModifiableWindowsApps` where users can add files that modify the app). Also see [Create a directory in any location based on packaged app directory](/windows/msix/manage/create-directory). Otherwise, get the same value as the [InstalledLocation](package_installedlocation.md) property. The mutable folder feature is currently available only for certain types of desktop PC games that are published by Microsoft and partners, and it enables those types of games to support modifications (mods).
 
 ## -see-also
 
 [MutableLocation](package_mutablelocation.md),[InstalledLocation](package_installedlocation.md)
 
 ## -examples
-

windows.applicationmodel/package_machineexternallocation.md

@@ -15,7 +15,7 @@ Gets the location of the machine-wide external folder specified in the package m
 
 ## -property-value
 
-The location of the machine-wide external folder specified in the package manifest for the current package.
+The location of the machine-wide external folder specified in the package manifest for the current package. If the package doesn't have the path requested, then gets `null`.
 
 ## -remarks
 

windows.applicationmodel/package_machineexternalpath.md

@@ -15,7 +15,7 @@ Gets the location of the machine-wide external folder specified in the package m
 
 ## -property-value
 
-The location of the machine-wide external folder specified in the package manifest for the current package.
+The location of the machine-wide external folder specified in the package manifest for the current package. If the package doesn't have the path requested, then gets an empty string.
 
 ## -remarks
 

windows.applicationmodel/package_userexternallocation.md

@@ -15,7 +15,7 @@ Gets the location of the per-user external folder specified in the package manif
 
 ## -property-value
 
-The location of the per-user external folder specified in the package manifest for the current package.
+The location of the per-user external folder specified in the package manifest for the current package. If the package doesn't have the path requested, then gets `null`.
 
 ## -remarks
 
@@ -34,4 +34,3 @@ To set the external folder, use one of the following combinations of [PackageMan
 [AddPackageByUriAsync](../windows.management.deployment/packagemanager_addpackagebyuriasync_797417417.md),[RegisterPackageByUriAsync](../windows.management.deployment/packagemanager_registerpackagebyuriasync_1415074502.md),[StagePackageByUriAsync](../windows.management.deployment/packagemanager_stagepackagebyuriasync_446584280.md)
 
 ## -examples
-

windows.applicationmodel/package_userexternalpath.md

@@ -15,7 +15,7 @@ Gets the path of the per-user external folder specified in the package manifest
 
 ## -property-value
 
-The path of the per-user external folder specified in the package manifest for the current package.
+The path of the per-user external folder specified in the package manifest for the current package. If the package doesn't have the path requested, then gets an empty string.
 
 ## -remarks
 
@@ -34,4 +34,3 @@ To set the external folder, use one of the following combinations of [PackageMan
 [AddPackageByUriAsync](../windows.management.deployment/packagemanager_addpackagebyuriasync_797417417.md),[RegisterPackageByUriAsync](../windows.management.deployment/packagemanager_registerpackagebyuriasync_1415074502.md),[StagePackageByUriAsync](../windows.management.deployment/packagemanager_stagepackagebyuriasync_446584280.md)
 
 ## -examples
-