Documentation update for WeMo disable_discovery configuration variable (#7314)

* WeMo - Disable Discovery - Documentation Update

* WeMo - Disable Discovery - Correct typos

* WeMo - Disable Discovery - Corrected bad default value for static

source/_components/wemo.markdown

@@ -2,7 +2,7 @@
 layout: page
 title: "Belkin WeMo"
 description: "Instructions on how to integrate Belkin WeMo devices into Home Assistant."
-date: 2016-02-20 00:41
+date: 2018-11-01 01:53
 sidebar: true
 comments: false
 sharing: true
@@ -17,41 +17,47 @@ The `wemo` component is the main component to integrate various [Belkin WeMo](ht
 
 ## {% linkable_title Configuration %}
 
-Supported devices will be automatically discovered if the discovery component is enabled. Loading the `wemo` component will scan the local network for WeMo devices, even if you are not using the discovery component
-
-```yaml
-# Example configuration.yaml entry
-wemo:
-```
-
 {% configuration %}
   static:
     description: One or more static IP adresses for WeMo to use
     required: false
     type: list
-    default: 1
+  disable_discovery:
+    description: Setting this value to true will prevent the automatic discovery of WeMo devices by the wemo platform and the discovery platform (static devices will still be discovered)
+    required: false
+    type: boolean
+    default: false
 {% endconfiguration %}
 
-Alternately, WeMo devices that are not discoverable can be statically configured. If you have WeMo devices on subnets other than where Home Assistant is running, or devices in a remote location reachable over a VPN, you will need to configure them manually. This is also useful if you wish to disable discovery for some WeMo's, even if they are local. Example static configuration:
+Supported devices will be automatically discovered if the optional `disable_discovery` configuration item is omitted or set to false or if the `discovery` component is enabled. If the `disable_discovery` configuration item is set to true, then automatic discovery of WeMo devices is disabled both for the `wemo` component and for the `discovery` component. Loading the `wemo` component with the `disable_discovery` configuration item omitted or set to false will scan the local network for WeMo devices, even if you are not using the `discovery` component.
 
 ```yaml
+# Example configuration.yaml entry with automatic discovery enabled
 wemo:
+  disable_discovery: false
+```
+
+Alternately, WeMo devices that are not discoverable can be statically configured. If you have WeMo devices on subnets other than where Home Assistant is running, or devices in a remote location reachable over a VPN, you will need to configure them manually. Statically configured devices may be used with or without automatic discovery enabled. Example static configuration:
+
+```yaml
+# Example configuration.yaml entry with automatic discovery disabled, and 2 statically configured devices
+wemo:
+  disable_discovery: true
   static:
     - 192.168.1.23
     - 192.168.52.172
 ```
 
-Any WeMo devices that are not statically configured but reachable via discovery will still be added automatically.
+Note that if you use static device entries, you may want to set up your router (or whatever runs your DHCP server) to force your WeMo devices to use a static IP address. Check the DHCP section of your router configuration for this ability.
 
-Note that if you use this, you may want to set up your router (or whatever runs your DHCP server) to force your WeMo devices to use a static IP address. Check the DHCP section of your router configuration for this ability.
+If the device doesn't seem to work and all you see is the state "unavailable" on your dashboard, check that your firewall doesn't block incoming requests on port 8989, since this is the port to which the WeMo devices send their updates.
-
-If the device doesn't seem to work and all you see is the state "unavailable" on your dashboard, check that your firewall doesn't block incoming request on port 8989 since this is the address to which the WeMo devices send their update.
 
 ## {% linkable_title Emulated devices %}
 
-Various software that emulates WeMo devices often uses alternative ports. Static configuration should include the port value:
+Various software that emulate WeMo devices often use alternative ports. Static configuration should include the port value:
 
 ```yaml
+# Example configuration.yaml entry with static device entries that include non-standard port numbers
 wemo:
   static:
     - 192.168.1.23:52001