update / improve GmsCompat documentation

1 files changed, 21 insertions, 21 deletions

diff --git a/static/usage.html b/static/usage.html
index 84e78954..e114fa7b 100644
--- a/static/usage.html
+++ b/static/usage.html
@@ -895,29 +895,29 @@
                     <h3><a href="#sandboxed-google-play-configuration">Configuration</a></h3>
 
                     <p>The compatibility layer has a configuration menu available at Settings ➔
-                    Apps ➔ Sandboxed Google Play. It provides links to this usage guide, Play
-                    services system settings, Google Location Accuracy setting, Play Store system
-                    settings and Google settings. The Play services and Play Store system settings
-                    are only included for convenience since they can be accessed the same way as
-                    any other app via Settings ➔ Apps. The Google Location Accuracy and Google
-                    settings activities would normally be integrated into the OS but we don't
-                    include any of the standard Google Play integration so there needs to be an
-                    app providing a way to access them.</p>
+                    Apps ➔ Sandboxed Google Play.</p>
 
-                    <p>The Google Location Accuracy toggle is an internal Google Play toggle for
-                    whether it will use their network-based location service. By default, it will
-                    only use the GNSS-based location provided by the OS. Some apps using the Play
-                    services geolocation service will only work if network-based geolocation is
-                    enabled if they lack a fallback to requesting the higher power usage
-                    GNSS-based geolocation when it's disabled.</p>
+                    <p>By default, apps using Google Play geolocation are redirected to our own
+                    implementation on top of the standard OS geolocation service. If you want to
+                    use Google's geolocation service instead, you can disable the "Reroute
+                    location requests to OS APIs" toggle and manually grant "Allow all the time"
+                    Location access to Google Play services. For it to be fully functional, you
+                    also need to use "Google Location Accuracy" link to access the Google Play
+                    services menu for opting into their network location service. This will send
+                    the nearby Wi-Fi and cellular networks provided via the Location permission to
+                    their service to retrieve a location estimate. The Nearby Devices permission
+                    can also be granted to give it access to nearby Bluetooth device IDs. If you
+                    stick with the default enabled redirection mode, none of this needs to be
+                    granted for working geolocation in apps.</p>
 
-                    <p>In the future, the Sandboxed Google Play app will provide a toggle for
-                    geolocation redirection. By default, apps using the Play services geolocation
-                    service will be redirected to an implementation based on the OS geolocation
-                    service without all the advanced features. This will enable apps using it to
-                    work out-of-the-box without needing to grant the Location permission to Play
-                    services. This has been largely developed but still needs substantial work
-                    before we can include it in the OS.</p>
+                    <p>The Google Location Accuracy and Google settings activities would normally
+                    be integrated into the OS but we don't include any of the standard Google Play
+                    integration so there needs to be an app providing a way to access them.</p>
+
+                    <p>The menu also provides links to this usage guide, Play services system
+                    settings, Play Store system settings and Google settings. The Play services
+                    and Play Store system settings are only included for convenience since they
+                    can be accessed the same way as any other app via Settings ➔ Apps.</p>
                 </section>
 
                 <section id="sandboxed-google-play-limitations">