Docs edits for selective stream archive/broadcast API enhancements

Author: jeffswartz

opentok/archives.py

@@ -31,7 +31,7 @@ class StreamModes(Enum):
     method."""
 
     auto = u("auto")
-    """Streams are automatically added to archive."""
+    """Streams are automatically added to the archive."""
     manual = u("manual")
     """Streams are included in the archive based on calls to the OpenTok.add_archive_stream()
     and OpenTok.remove_archive_stream() methods."""
@@ -70,7 +70,7 @@ class Archive(object):
     
     :ivar streams:
         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".
+        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

@@ -13,7 +13,7 @@ class Broadcast(object):
     
     :ivar streams:
         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".
+        the status set to "started" and the stream_Mode set to "manual".
     """
 
     def __init__(self, kwargs):
@@ -39,7 +39,7 @@ class BroadcastStreamModes(Enum):
     method."""
 
     auto = u("auto")
-    """Streams are automatically added to broadcast."""
+    """Streams are automatically added to the broadcast."""
     manual = u("manual")
     """Streams are included in the broadcast based on calls to the OpenTok.add_broadcast_stream()
     and OpenTok.remove_broadcast_stream() methods."""

opentok/opentok.py

@@ -527,9 +527,10 @@ def start_archive(
             String 'screenshareType' optional: Layout to use for screenshares. If this is set, you must
             set 'type' to 'bestFit'
 
-        :param StreamModes stream_mode: Determines the archive stream handling mode. It's set to 'auto' by
-        default if you want all streams to get added and set to 'manual' if you want to explicitly select 
-        the streams in the archive.
+        :param StreamModes stream_mode (Optional): Determines the archive stream handling mode.
+        Set this to StreamModes.auto (the default) to have streams added automatically. Set this to
+        StreamModes.manual to explicitly select streams to include in the the archive, using the
+        OpenTok.add_archive_stream() and OpenTok.remove_archive_stream() methods.
 
         :rtype: The Archive object, which includes properties defining the archive,
           including the archive ID.
@@ -1246,10 +1247,6 @@ def start_broadcast(self, session_id, options, stream_mode=BroadcastStreamModes.
                 String 'screenshareType' optional: Layout to use for screenshares. If this is set, you must
                 set 'type' to 'bestFit'
 
-        :param StreamModes stream_mode: Determines the archive stream handling mode. It's set to 'auto' by
-        default if you want all streams to get added and set to 'manual' if you want to explicitly select 
-        the streams in the broadcast.
-
             Integer 'maxDuration' optional: The maximum duration for the broadcast, in seconds.
             The broadcast will automatically stop when the maximum duration is reached. You can
             set the maximum duration to a value from 60 (60 seconds) to 36000 (10 hours). The
@@ -1265,6 +1262,11 @@ def start_broadcast(self, session_id, options, stream_mode=BroadcastStreamModes.
             String 'resolution' optional: The resolution of the broadcast, either "640x480"
             (SD, the default) or "1280x720" (HD)
 
+        :param BroadcastStreamModes stream_mode (Optional): Determines the broadcast stream handling mode.
+        Set this to BroadcastStreamModes.auto (the default) to have streams added automatically. Set this to
+        BroadcastStreamModes.manual to explicitly select streams to include in the the broadcast, using the
+        OpenTok.add_broadcast_stream() and OpenTok.remove_broadcast_stream() methods.
+
         :rtype A Broadcast object, which contains information of the broadcast: id, sessionId
         projectId, createdAt, updatedAt, resolution, status and broadcastUrls
         """