diff --git a/source/developers/platform_example_light.markdown b/source/developers/platform_example_light.markdown
index c50e2ca6e4a..b534fc8e370 100644
--- a/source/developers/platform_example_light.markdown
+++ b/source/developers/platform_example_light.markdown
@@ -64,7 +64,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None):
     add_devices(AwesomeLight(light) for light in hub.lights())
 
 class AwesomeLight(Light):
-    """Represents an AwesomeLight in Home Assistant."""
+    """Representation an AwesomeLight in Home Assistant."""
 
     def __init__(self, light):
         """Initialize an AwesomeLight."""
@@ -72,7 +72,7 @@ class AwesomeLight(Light):
 
     @property
     def name(self):
-        """Return the display name of this light"""
+        """Return the display name of this light."""
         return self._light.name
 
     @property
@@ -86,7 +86,7 @@ class AwesomeLight(Light):
 
     @property
     def is_on(self):
-        """If light is on."""
+        """Return true if light is on."""
         return self._light.is_on()
 
     def turn_on(self, **kwargs):
@@ -105,7 +105,7 @@ class AwesomeLight(Light):
     def update(self):
         """Fetch new state data for this light.
 
-        This is the only method that should fetch new data for Home Assitant.
+        This is the only method that should fetch new data for Home Assistant.
         """
         self._light.update()
 ```