-# Change the pwm range used for this software pwm by changing this setting.
-# The default pwm range of 167 makes for an approximate 60Hz pwm frequency.
+# TODO(toddgiles): Add a page to the wiki with examples of different types of lights and
+# relays and the effect produced for various PWM ranges. The text below should be taken
+# with a grain of salt as I have not been able to test as completely as I'd like to yet.
+# Change the pwm range used for this software pwm by changing this setting. The optimal
+# setting really depends on your hardware setup. If you are using zero-cross relays and
+# driving an AC load then using a pwm range of 500 gives decent results (flickering
+# effect for many led lights with input rectifiers, and a decent fade for incandescents).
+# A range of 500 generates a 20Hz pwm frequency.
+# If you have random cross relays that can shut-off / on at any time then going for a
+# 60 Hz pwm frequency can be advantageous, although timing this to the actual zero crossings
+# of the power line used will give the best fading effect - again with incandescent bulbs.
+# A range of 167 approximately generates a 60Hz pwm frequency.
+# If you are attempting to fade a DC led load then the default range of 100 which gives a
+# 100Hz pwm frequency works fine.