Merge pull request #47 from brentru/update-docstring-callbacks

Clarify feed callback docstrings

Author: tannewt

adafruit_io/adafruit_io.py

@@ -205,8 +205,12 @@ def _on_unsubscribe_mqtt(self, client, user_data, topic, pid):
             self.on_unsubscribe(self, user_data, topic, pid)
 
     def add_feed_callback(self, feed_key, callback_method):
-        """Executes callback_method whenever a message is
-        received on feed_key.
+        """Attaches a callback_method to an Adafruit IO feed.
+        The callback_method function is called when a
+        new value is written to the feed.
+
+        NOTE: The callback_method registered to this method
+        will only execute during loop().
         :param str feed_key: Adafruit IO feed key.
         :param str callback_method: Name of callback method.
 
@@ -218,6 +222,9 @@ def add_feed_callback(self, feed_key, callback_method):
     def remove_feed_callback(self, feed_key):
         """Removes a previously registered callback method
         from executing whenever feed_key receives new data.
+
+        After this method is called, incoming messages
+        call the shared on_message.
         :param str feed_key: Adafruit IO feed key.
 
         """