Some docs edits

Author: jeffswartz

opentok/archives.py

@@ -27,12 +27,14 @@ class OutputModes(Enum):
     """Each stream in the archive is recorded to an individual file."""
 
 class StreamModes(Enum):
-    """"List of valid settings for the stream_mode parameter of the OpenTok.start_archive()"""
+    """"List of valid settings for the stream_mode parameter of the OpenTok.start_archive()
+    method."""
 
     auto = u("auto")
-    """Streams will automatically be selected and added to archive"""
+    """Streams are automatically added to archive."""
     manual = u("manual")
-    """Customers select which streams get added to archive"""
+    """Streams are included in the archive based on calls to the OpenTok.add_archive_stream()
+    and OpenTok.remove_archive_stream() methods."""
 
 class Archive(object):
     """Represents an archive of an OpenTok session.
@@ -63,12 +65,12 @@ class Archive(object):
         (OutputModes.composed) or to individual files (OutputModes.individual).
 
     :ivar streamMode:
-        Determines the archive stream handling mode. It's set to 'auto' by
-        default if you want all streams. To explicitly select specific streams 
-        in the archive then set to 'manual'.
+        Whether streams included in the archive are selected automatically
+        ("auto", the default) or manually ("manual"). 
     
     :ivar streams:
-        A list of streams in an archive.
+        A list of streams currently being archived. This is only set for an archive with
+        the status set to "started"  and the stream_Mode set to "manual".
 
     :ivar partner_id:
        The API key associated with the archive.

opentok/broadcast.py

@@ -6,15 +6,15 @@
 
 class Broadcast(object):
     """
-    Represents a live streaming broadcast
+    Represents a live streaming broadcast.
 
     :ivar streamMode:
-        Determines the broadcast stream handling mode. It's set to 'auto' by
-        default if you want all streams. To explicitly select specific streams 
-        in the broadcast then set to 'manual'.
+        Whether streams included in the broadcast are selected automatically
+        ("auto", the default) or manually ("manual"). 
     
     :ivar streams:
-        A list of streams in a broadcast.
+        A list of streams currently being broadcast. This is only set for a broadcast with
+        the status set to "started"  and the stream_Mode set to "manual".
     """
 
     def __init__(self, kwargs):
@@ -36,9 +36,11 @@ def json(self):
         return json.dumps(self, default=lambda o: o.__dict__, sort_keys=True, indent=4)
 
 class BroadcastStreamModes(Enum):
-    """"List of valid settings for the stream_mode parameter of the OpenTok.start_broadcast()"""
+    """"List of valid settings for the stream_mode parameter of the OpenTok.start_broadcast()
+    method."""
 
     auto = u("auto")
-    """Streams will automatically be selected and added to broadcase"""
+    """Streams are automatically added to broadcast."""
     manual = u("manual")
-    """Customers select which streams get added to broadcast"""
+    """Streams are included in the broadcast based on calls to the OpenTok.add_broadcast_stream()
+    and OpenTok.remove_broadcast_stream() methods."""