diff --git a/sdk/fidl/fuchsia.wlan.policy/README.md b/sdk/fidl/fuchsia.wlan.policy/README.md
index 3d23312..712b012 100644
--- a/sdk/fidl/fuchsia.wlan.policy/README.md
+++ b/sdk/fidl/fuchsia.wlan.policy/README.md
@@ -290,7 +290,9 @@
 <p>Triggers a network scan.  Note, even in normal operation, some scan requests
 may be rejected due to timing with connection establishment or other critical
 connection maintenance.  If the scan is cancelled or errors, the caller is
-notified via a status update in the ScanResultIterator.</p>
+notified via a status update in the ScanResultIterator.
+In the current implementation, client connections must be started for a scan
+to be performed.</p>
 
 #### Request
 <table>
@@ -306,10 +308,10 @@
 
 ### StartClientConnections {#fuchsia.wlan.policy/ClientController.StartClientConnections}
 
-<p>Enables wlan to initiate connections to networks (either autoconnect to
-saved networks or act on incoming calls triggering connections).  Depending
-on the underlying capabilities of the device, this call may impact other
-device operation (for example, acting as an access point).</p>
+<p>Enables wlan to initiate connections to networks (either by autoconnecting
+to saved networks or acting on incoming calls triggering connections).
+Depending on the underlying capabilities of the device, this call may impact
+other device operation (for example, acting as an access point).</p>
 
 #### Request
 <table>
@@ -329,7 +331,8 @@
 
 ### StopClientConnections {#fuchsia.wlan.policy/ClientController.StopClientConnections}
 
-<p>Disables connections to wlan networks and tears down any existing connections.</p>
+<p>Tears down any existing connections to wlan networks and disables initiation of
+new connections.</p>
 
 #### Request
 <table>
@@ -406,7 +409,7 @@
 
 
 ## ClientStateUpdates {#ClientStateUpdates}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#149)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#151)*
 
 <p>Wlan status changes for client connections and the associated network state.
 These updates contain information about whether or not the device will attempt
@@ -440,7 +443,7 @@
     </table>
 
 ## NetworkConfigIterator {#NetworkConfigIterator}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#136)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#138)*
 
 <p>Iterator used by callers to retrieve saved network information.</p>
 
@@ -465,7 +468,7 @@
         </tr></table>
 
 ## ScanResultIterator {#ScanResultIterator}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#87)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#90)*
 
 <p>Iterator used to send back scan results to the caller.  The corresponding channel
 will be closed after the scan is complete and results are returned or fails due
@@ -499,7 +502,7 @@
 ## **STRUCTS**
 
 ### ClientController_RemoveNetwork_Response {#ClientController_RemoveNetwork_Response}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#68)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#71)*
 
 
 
@@ -508,7 +511,7 @@
 </table>
 
 ### ClientController_SaveNetwork_Response {#ClientController_SaveNetwork_Response}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#63)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#66)*
 
 
 
@@ -555,7 +558,7 @@
 </table>
 
 ### ScanResultIterator_GetNext_Response {#ScanResultIterator_GetNext_Response}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#92)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#95)*
 
 
 
@@ -577,7 +580,7 @@
 ### Compatibility {#Compatibility}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#191)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#193)*
 
 <p>High level compatibility for the scan result.  Not all network security protocols
 are supported.  New protocols may be detected before they are connectable
@@ -607,7 +610,7 @@
 ### ConnectionState {#ConnectionState}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#210)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#212)*
 
 <p>Connection states used to update registered wlan observers.</p>
 
@@ -662,7 +665,7 @@
 ### DisconnectStatus {#DisconnectStatus}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#226)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#228)*
 
 <p>Disconnect and connection attempt failure status codes</p>
 
@@ -699,7 +702,7 @@
 ### NetworkConfigChangeError {#NetworkConfigChangeError}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#205)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#207)*
 
 <p>Potential error cases for saving and removing network configurations.  This is
 intentionally sparse and will be expanded as use cases develop.</p>
@@ -769,7 +772,7 @@
 ### ScanErrorCode {#ScanErrorCode}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#96)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#99)*
 
 <p>Wlan scan error codes.</p>
 
@@ -824,7 +827,7 @@
 ### WlanClientState {#WlanClientState}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#182)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#184)*
 
 <p>Wlan operating state for client connections</p>
 
@@ -908,7 +911,7 @@
 ### Bss {#Bss}
 
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#121)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#123)*
 
 <p>Information for a particular ScanResult entry.</p>
 
@@ -952,7 +955,7 @@
 ### ClientStateSummary {#ClientStateSummary}
 
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#161)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#163)*
 
 <p>Information about the current client state for the device.  This includes if the
 device will attempt to connect to access points (when applicable), any existing
@@ -1031,7 +1034,7 @@
 ### NetworkState {#NetworkState}
 
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#170)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#172)*
 
 <p>Information about current network connections and attempts.</p>
 
@@ -1067,7 +1070,7 @@
 ### ScanResult {#ScanResult}
 
 
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#108)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#110)*
 
 <p>Information from an observed wlan network.  This includes the
 network name, security type, detected access point information and network
@@ -1108,7 +1111,7 @@
 ## **UNIONS**
 
 ### ClientController_RemoveNetwork_Result {#ClientController_RemoveNetwork_Result}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#68)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#71)*
 
 
 <table>
@@ -1127,7 +1130,7 @@
         </tr></table>
 
 ### ClientController_SaveNetwork_Result {#ClientController_SaveNetwork_Result}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#63)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#66)*
 
 
 <table>
@@ -1175,7 +1178,7 @@
         </tr></table>
 
 ### ScanResultIterator_GetNext_Result {#ScanResultIterator_GetNext_Result}
-*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#92)*
+*Defined in [fuchsia.wlan.policy/client_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.policy/client_provider.fidl#95)*
 
 
 <table>