diff --git a/esphomeyaml/changelog/index.rst b/esphomeyaml/changelog/index.rst
index e323cda92..b366ef128 100644
--- a/esphomeyaml/changelog/index.rst
+++ b/esphomeyaml/changelog/index.rst
@@ -47,7 +47,7 @@ New Features
   flashing on Windows/MacOS machines **without having to install esphomeyaml**. So if esphomeyaml for some reason
   can't find your USB port, you now can use the esphomeflasher app. See :ref:`esphomeflasher`.
 
-- ESP8266s now save the states of lights/switches/... internally and restore them on boot. (:libpr:`258`)
+- ESP8266s now save the states of lights/switches/... internally and restores them on boot. (:libpr:`258`)
 
 - The :doc:`Over-the-Air Update </esphomeyaml/components/ota>` process was quite buggy sometimes and the Arduino-library
   esphomelib used was doing some weird stuff. The OTA-process has now been completely re-written to be more stable
@@ -104,6 +104,9 @@ New Features
 
 - You can now upload OTA firmware files with the :doc:`web server component </esphomeyaml/components/web_server>`
 
+- Added the ability to define global variables in esphomeyaml: :ref:`config-globals`.
+
+- Added a ``frequency`` option to the :doc:`/esphomeyaml/components/output/esp8266_pwm`.
 
 Breaking Changes
 ----------------
diff --git a/esphomeyaml/components/output/esp8266_pwm.rst b/esphomeyaml/components/output/esp8266_pwm.rst
index 5b9519ece..7522d9ffb 100644
--- a/esphomeyaml/components/output/esp8266_pwm.rst
+++ b/esphomeyaml/components/output/esp8266_pwm.rst
@@ -8,8 +8,6 @@ limitations.
 
 - There can be a noticeable amount of flickering with increased WiFi activity.
 - The output range only goes up to about 80%.
-- It’s mostly fixed to a frequency of 1kHz, you can :ref:`increase this a
-  bit manually <esp8266_pwm-example_usage>` in code though.
 
 If you need a stable PWM signal, it’s definitely recommended to use the
 successor of the ESP8266, the ESP32, and its :doc:`ESP32 LEDC PWM <ledc>` instead.
@@ -20,6 +18,7 @@ successor of the ESP8266, the ESP32, and its :doc:`ESP32 LEDC PWM <ledc>` instea
     output:
       - platform: esp8266_pwm
         pin: D1
+        frequency: 1000 Hz
         id: pwm-output
 
 Configuration variables:
@@ -27,6 +26,8 @@ Configuration variables:
 
 - **pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The pin to use PWM on.
 - **id** (**Required**, :ref:`config-id`): The id to use for this output component.
+- **frequency** (*Optional*, frequency): The frequency to run the PWM with. Lower frequencies
+  have more visual artifacts, but can represent much more colors. Defaults to ``1000 Hz``.
 - All other options from :ref:`Output <config-output>`.
 
 See Also