Updates to docs

Author: Paris Morgan

articles/spatial-anchors/concepts/anchor-relationships-way-finding.md

@@ -68,7 +68,7 @@ You can continue this procedure for more anchors and more sessions over time.
 
 ### Verify anchor connections
 
-The app can verify that two anchors are connected by issuing a query for nearby anchors. When the query's result contains the target anchor, the anchor connection is verified. If the anchors aren't connected, the app can try to connect them again.
+The app can verify that two anchors are connected by issuing a query for nearby anchors, which you do by setting the `NearAnchorCriteria` on a `CloudSpatialAnchorWatcher`. When the query's result contains the target anchor, the anchor connection is verified. If the anchors aren't connected, the app can try to connect them again.
 
 Here are some reasons why anchors might fail to connect:
 

articles/spatial-anchors/concepts/guidelines-effective-anchor-experiences.md

@@ -15,9 +15,13 @@ ms.service: azure-spatial-anchors
 
 This article provides guidelines and considerations to help you effectively create and locate anchors by using Spatial Anchors.
 
+## Anchor improvement over time
+
+With Azure Spatial Anchors, each time you locate anchors, we attempt to improve the quality of future locate operations. We do this by using the environment data collected to augment the visual information on the anchors we are looking for. This process runs under the hood and is an offline optimization run by Azure Spatial Anchors to optimize for your environment. The additional data gathered during each operation builds a stronger understanding of the environment. This improves quality and allows you to better locate anchors through environment change, time passing, and for users looking at anchors from different angles and perspectives.
+
 ## Good anchors
 
-Spatial Anchors helps you create good anchors. It's important to invest time in either educating or guiding users in your user experience (UX) to create good anchors. By investing in creating good anchors up front, you help end users to reliably find anchors:
+While Azure Spatial Anchors does attempt to improve the quality of anchors over time, it is also important to invest time in either educating or guiding users in your user experience (UX) to create good anchors. By investing in creating good anchors up front, you help end users to reliably find anchors:
 
 - Across different devices.
 - At various times.

articles/spatial-anchors/overview.md

@@ -36,7 +36,7 @@ sections provide information about getting started with building apps using Azur
 
 ## Next steps
 
-Create your first app with Spatial Anchors.
+Create your first app with Azure Spatial Anchors.
 
 > [!div class="nextstepaction"]
 > [Unity (HoloLens)](quickstarts/get-started-unity-hololens.md)

articles/spatial-anchors/spatial-anchor-faq.md

@@ -45,6 +45,10 @@ For more information, see [Azure Spatial Anchors overview](overview.md).
 
 **A:** Anchors are isolated by Azure account. Only apps to which you grant access to your account will be able to access anchors within the account.
 
+**Q: How does Azure Spatial Anchors store data?**
+
+**A:** All data is stored encrypted in our system, with a Microsoft managed data encryption key.
+
 **Q: What information about an environment is transmitted and stored on the service when using Azure Spatial Anchors? Are pictures of the environment transmitted and stored?**
 
 **A**: When creating or locating anchors, pictures of the environment are processed on the device into a derived format. This derived format is transmitted to and stored on the service.
@@ -56,7 +60,6 @@ Azure Spatial Anchors adheres to the [Azure Service Agreement Terms](https://go.
 ![An environment and its derived sparse point cloud](./media/sparse-point-cloud.png)
 *Figure 1: An environment and its derived sparse point cloud*
 
-
 **Q: Is there a way I can send diagnostics information to Microsoft?**
 
 **A**: Yes. Azure Spatial Anchors has a diagnostics mode that developers can choose to opt into through the Azure Spatial Anchors API. This is useful, for example, if you encounter an environment where you are unable to create and locate anchors predictably. We may ask if you can submit a diagnostics report containing information that helps us debug. For more information see [Logging and diagnostics in Azure Spatial Anchors](./concepts/logging-diagnostics.md).

articles/spatial-anchors/unity-overview.md

@@ -12,7 +12,7 @@ ms.topic: conceptual
 
 # Building in Unity with Azure Spatial Anchors
 
-Developers can choose Unity for creating and deploying mixed reality applications that use Azure Spatial Anchors. 
+Developers can choose Unity for creating and deploying mixed reality applications that use Azure Spatial Anchors.
 The following platforms are supported:
 
 **Unity for HoloLens**

includes/spatial-anchors-create-locate-anchors-frames.md

@@ -1,3 +1,3 @@
 ## Provide frames to the session
 
-The spatial anchor session works by mapping the space around the user. Doing so helps to determine where anchors are located. Mobile platforms (iOS & Android) require a native call to the camera feed to obtain frames from your platform's AR library. In contrast, HoloLens is constantly scanning the environment, so there's no need for a specific call like on Mobile.
+The spatial anchor session works by mapping the space around the user. Doing so helps to determine where anchors are located. Mobile platforms (iOS & Android) require a native call to the camera feed to obtain frames from your platform's AR library. In contrast, HoloLens is constantly scanning the environment, so there's no need for a specific call like on mobile platforms.

includes/spatial-anchors-create-locate-anchors-locating.md

@@ -5,6 +5,9 @@ Being able to locate a previously saved cloud spatial anchor is one of the main
 - Locate anchors connected to a previously located anchor. You can learn about anchor relationships [here](/azure/spatial-anchors/concepts/anchor-relationships-way-finding/).
 - Locate anchor using [Coarse relocalization](/azure/spatial-anchors/concepts/coarse-reloc/).
 
+> [!NOTE]
+> Each time you locate an anchor, Azure Spatial Anchors will attempt to use the environment data collected to augment the visual information on the anchor. If you are having trouble locating an anchor, it can be useful to create an anchor, then locate it several times from different angles and lighting conditions.
+
 If you are locating cloud spatial anchors by identifier, you will want to store the cloud spatial anchor identifier in your application's back-end service, and make it accessible to all devices that can properly authenticate to it. For an example of this, see [Tutorial: Share Spatial Anchors across devices](/azure/spatial-anchors/tutorials/tutorial-share-anchors-across-devices/).
 
 Instantiate an `AnchorLocateCriteria` object, set the identifiers you're looking for, and invoke the `CreateWatcher` method on the session by providing your `AnchorLocateCriteria`.

includes/spatial-anchors-create-locate-anchors-setup-ios.md

@@ -1,5 +1,5 @@
 ## Setting up the library
 
-Invoke Start() to enable your session to process environment data.
+Invoke `Start()` to enable your session to process environment data.
 
-To handle events raised by your session, set the `delegate` property of your session to an object, like your view. This object must implement the SSCCloudSpatialAnchorSessionDelegate protocol.
+To handle events raised by your session, set the `delegate` property of your session to an object, like your view. This object must implement the `SSCCloudSpatialAnchorSessionDelegate` protocol.

includes/spatial-anchors-create-locate-anchors-stopping.md

@@ -1,3 +1,3 @@
 ## Pause, reset, or stop the session
 
-To stop the session temporarily, you can invoke `Stop()`. Doing so will stop any watchers and environment processing, even if you invoke ProcessFrame(). You can then invoke `Start()` to resume processing. When resuming, environment data already captured in the session is maintained.
+To stop the session temporarily, you can invoke `Stop()`. Doing so will stop any watchers and environment processing, even if you invoke `ProcessFrame()`. You can then invoke `Start()` to resume processing. When resuming, environment data already captured in the session is maintained.