Change promote script to be able to archive to the new gs://dart-archive/ location

tools/bots/bot_utils.py

Index: tools/bots/bot_utils.py
diff --git a/tools/bots/bot_utils.py b/tools/bots/bot_utils.py
index c506014f611258430fc4fa8c2555afc081525856..a1a639fd5da380c857abf1539d8f9624267e6045 100644
--- a/tools/bots/bot_utils.py
+++ b/tools/bots/bot_utils.py
@@ -60,9 +60,28 @@ class Mode(object):
   ALL_MODES = [RELEASE, DEBUG]
 
 class GCSNamer(object):
+  """
+  This class is used for naming objects in our "gs://dart-archive/"
+  GoogleCloudStorage bucket. It's structure is as follows:
+
+  For every (channel,revision,release-type) tuple we have a base path:
+
+    gs://dart-archive/channels/{be,dev,stable}
+                     /{raw,signed,release}/{revision,latest}/
+
+  Under every base path, the following structure is used:
+    - /VERSION
+    - /api-docs/dart-api-docs.zip
+    - /dartium/{chromedriver,content_shell,dartium}
+         -{linux,macos,windows}-{ia32,x64}-release.zip
+    - /sdk/dartsdk-{linux,macos,windows}-{ia32,x64}-release.zip
+    - /editor/darteditor-{linux,macos,windows}-{ia32,x64}.zip
+    - /editor-eclipse-update
+         /{index.html,features/,plugins/,artifacts.jar,content.jar}
+  """
   def __init__(self, channel=Channel.BLEEDING_EDGE,
       release_type=ReleaseType.RAW):
-    assert channel in Channel.ALL_CHANNELS 
+    assert channel in Channel.ALL_CHANNELS
     assert release_type in ReleaseType.ALL_TYPES
 
     self.channel = channel