Update docstings

homeassistant/components/input_boolean.py

@@ -1,4 +1,6 @@
 """
+homeassistant.components.input_boolean
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Component to keep track of user controlled booleans for within automation.
 
 For more details about this component, please refer to the documentation

homeassistant/components/insteon.py

@@ -3,7 +3,7 @@ homeassistant.components.insteon
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Support for Insteon Hub.
 
-For more details about this platform, please refer to the documentation at
+For more details about this component, please refer to the documentation at
 https://home-assistant.io/components/insteon/
 """
 import logging

homeassistant/components/rpi_gpio.py

@@ -1,6 +1,6 @@
 """
 homeassistant.components.rpi_gpio
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Allows to control the GPIO pins of a Raspberry Pi.
 
 For more details about this platform, please refer to the documentation at

homeassistant/components/sensor/nest.py

@@ -1,6 +1,6 @@
 """
 homeassistant.components.sensor.nest
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Support for Nest Thermostat Sensors.
 
 For more details about this platform, please refer to the documentation at
@@ -30,7 +30,7 @@ SENSOR_TEMP_TYPES = ['temperature',
 
 
 def setup_platform(hass, config, add_devices, discovery_info=None):
-    "Setup Nest Sensor from config file"
+    """ Setup Nest Sensor. """
 
     logger = logging.getLogger(__name__)
     try:
@@ -85,11 +85,11 @@ class NestBasicSensor(NestSensor):
     @property
     def state(self):
         """ Returns the state of the sensor. """
-
         return getattr(self.device, self.variable)
 
     @property
     def unit_of_measurement(self):
+        """ Unit the value is expressed in. """
         return SENSOR_UNITS.get(self.variable, None)
 
 
@@ -98,10 +98,12 @@ class NestTempSensor(NestSensor):
 
     @property
     def unit_of_measurement(self):
+        """ Unit the value is expressed in. """
         return TEMP_CELCIUS
 
     @property
     def state(self):
+        """ Returns the state of the sensor. """
         temp = getattr(self.device, self.variable)
         if temp is None:
             return None