Put in recomendations for some clarifications.

source/components/index.markdown

@@ -89,9 +89,15 @@ Entities are things that you want to observe within Home Assistant. Support for
 </tr>
 
 <tr>
-  <td><a href='/components/isy994.html'><img src='/images/supported_brands/universal_devices.png' class='brand overview' /></a></td>
-  <td><a href='/components/isy994.html'>Insteon and X10 Devices</a></td>
-  <td>ISY994 controller for Insteon and X10 devices as well as create custom switches and sensors.</td>
+  <td><a href='/components/isy994.html'><img src='/images/supported_brands/insteon.png' class='brand overview' /></a></td>
+  <td><a href='/components/isy994.html'>Insteon Devices</a></td>
+  <td>Insteon devices can be controlled with the ISY994 controller.</td>
+</tr>
+
+<tr>
+  <td><a href='/components/isy994.html'><img src='/images/supported_brands/x10.gif' class='brand overview' /></a></td>
+  <td><a href='/components/isy994.html'>X10 Devices</a></td>
+  <td>X10 devices can be controlled with the ISY994 controller.</td>
 </tr>
 
 </table>
@@ -115,6 +121,7 @@ Home Assistant integrates with a variety of third party Home Automation hubs and
 [<img src='/images/supported_brands/telldus_tellstick.png' class='brand' />](/components/tellstick.html)
 [<img src='/images/supported_brands/vera.png' class='brand' />](/components/vera.html)
 [<img src='/images/supported_brands/wink.png' class='brand' />](/components/wink.html)
+[<img src='/images/supported_brands/universal_devices.png' class='brand' />](/components/isy994.html)
 
 <p class='note'>
 Support for these devices is provided by the Home Assistant community and not
@@ -173,6 +180,11 @@ the manufacturers of these devices.
 </tr>
 </table>
 
+<p class='note'>
+Support for these services is provided by the Home Assistant community and not
+the service providers.
+</p>
+
 ## {% linkable_title Automation %}
 
 | Type | Description

source/components/isy994.markdown

@@ -43,9 +43,9 @@ The ISY_USERNAME and ISY_PASSWORD are the configured username and password used
 to access the ISY interface.
 
 The SENSOR_STRING is a string that is used to identify which devices are to be
-treated as sensors instead of lights of switches. By default, this string is
+assumed to be sensors instead of lights of switches. By default, this string is
 'Sensor'. If this string is found in the device name, Home Assistant will
-assume treat is as a sensor.
+assume it is as a sensor.
 
 The HIDDEN_STRING is a string that is used to identify which devices are to be
 hidden on Home Assistant's front page. This string will be stripped from the

source/developers/add_new_platform.markdown

@@ -65,14 +65,13 @@ This option is currently limited to built-in components.
 ### {% linkable_title Creating Entities %}
 
 Home Assistant will call a function with the following signature to initialize
-your new component. This function must exist in the component module you
-create.
+your new platform. This function must exist in the platform module you create.
 
 ```python
 def setup_platform(hass, config, add_devices, discovery_info=None)
 ```
 
-In this function, your component should create the appropriate entities and
+In this function, your platform should create the appropriate entities and
 register them with the Home Assistant core. Entities are Home Assistant's
 representation of lights, switches, sensors, etc. It is best practice for all
 new entities to inherit the

source/getting-started/configuration.markdown

@@ -67,29 +67,31 @@ Not all devices can be discovered, so if you have any of the following devices o
 
 See the [components overview page](/components/) for a complete list of supported devices.
 
-### {% linkable_title Hiding devices and services %}
+### {% linkable_title Customizing devices and services %}
 
-By default, most of your devices will be visible on the Home Assistant Sates
-page. You may find it desireable to hide some of these devices from the default
-view. Some components may also hide some entities by default. You also have the
-ability to show these previously hidden entities.
+By default, most of your devices will be visible on the Home Assistant States
+page and have a default icon determined by their domain. You may find it 
+desireable to customize the look and feel of your front page by altering some
+of these parameters.
 
-Most enties on the homepage may be hidden or shown in the configuration file by
-adding the following lines to the homeassistant section:
+By adding the following parameters to the *homeassistant* section of your
+*configuration.yaml* file, you can customize the attributes of any state on
+your front page.
 
 ```yaml
 homeassistant:
 
     # Add this to your existing configuration
 
-    visibility:
-        entity_id: hide
-        entity_id: show
+    customize:
+        SOME_ENTITY_ID:
+            hidden: true
+            entity_picture: http://URL.TO/PICTURE
+            friendly_name: SOME CUSTOM NAME
 ```
 
-Replace entity_id with the ID for the entity that you would like to either show
-or hide. Entity IDs can be retrieved from the web interface by using the Set
-State page in the Developer Tools.
+Entity IDs can be retrieved from the web interface by using the Set State page 
+in the Developer Tools.
 
 ### {% linkable_title Setting up Home Automation %}