Bug 1252976 - Follow up, Update Note on Artifact Mode, r=nalexander draft
authorTimothy Guan-tin Chien <timdream@gmail.com>
Mon, 08 Aug 2016 17:54:24 +0800
changeset 398368 7ba21088836bacaed3a4482f704ce6b9be2d395e
parent 398367 971c124e1db8655194f2a126aa3f2458aa32ac12
child 527644 943661bcc1bde31b18cdc7622b0ac83a2b82b1fd
push id25510
push userbmo:timdream@gmail.com
push dateTue, 09 Aug 2016 01:44:23 +0000
reviewersnalexander
bugs1252976
milestone51.0a1
Bug 1252976 - Follow up, Update Note on Artifact Mode, r=nalexander Contains a few sentences copied from MDN. MozReview-Commit-ID: 2wgcCNiWkWw
python/mozboot/mozboot/bootstrap.py
--- a/python/mozboot/mozboot/bootstrap.py
+++ b/python/mozboot/mozboot/bootstrap.py
@@ -24,51 +24,57 @@ from mozboot.mozillabuild import Mozilla
 from mozboot.util import (
     get_state_dir,
 )
 
 APPLICATION_CHOICE = '''
 Please choose the version of Firefox you want to build:
 %s
 
-Note: (For Firefox for Android)
+Note on Artifact Mode:
 
-The Firefox for Android front-end is built using Java, the Android
-Platform SDK, JavaScript, HTML, and CSS. If you want to work on the
-look-and-feel of Firefox for Android, you want "Firefox for Android
-Artifact Mode".
+Firefox for Desktop and Android supports a fast build mode called
+artifact mode. Artifact mode downloads pre-built C++ components rather
+than building them locally, trading bandwidth for time.
+
+Artifact builds will be useful to many developers who are not working
+with compiled code. If you want to work on look-and-feel of Firefox,
+you want "Firefox for Desktop Artifact Mode".
 
-Firefox for Android is built on top of the Gecko technology
-platform. Gecko is Mozilla's web rendering engine, similar to Edge,
-Blink, and WebKit. Gecko is implemented in C++ and JavaScript. If you
-want to work on web rendering, you want "Firefox for Android".
+Similarly, if you want to work on the look-and-feel of Firefox for Android,
+you want "Firefox for Android Artifact Mode".
 
-If you don't know what you want, start with just "Firefox for Android
-Artifact Mode". Your builds will be much shorter than if you build
-Gecko as well. But don't worry! You can always switch configurations
-later.
+To work on the Gecko technology platform, you would need to opt to full,
+non-artifact mode. Gecko is Mozilla's web rendering engine, similar to Edge,
+Blink, and WebKit. Gecko is implemented in C++ and JavaScript. If you
+want to work on web rendering, you want "Firefox for Desktop", or
+"Firefox for Android".
+
+If you don't know what you want, start with just Artifact Mode of the desired
+platform. Your builds will be much shorter than if you build Gecko as well.
+But don't worry! You can always switch configurations later.
 
 You can learn more about Artifact mode builds at
 https://developer.mozilla.org/en-US/docs/Artifact_builds.
 
 Your choice:
 '''
 
 APPLICATIONS_LIST=[
+    ('Firefox for Desktop Artifact Mode', 'browser_artifact_mode'),
     ('Firefox for Desktop', 'browser'),
-    ('Firefox for Desktop Artifact Mode', 'browser_artifact_mode'),
     ('Firefox for Android Artifact Mode', 'mobile_android_artifact_mode'),
     ('Firefox for Android', 'mobile_android'),
 ]
 
 # This is a workaround for the fact that we must support python2.6 (which has
 # no OrderedDict)
 APPLICATIONS = dict(
-    browser=APPLICATIONS_LIST[0],
-    browser_artifact_mode=APPLICATIONS_LIST[1],
+    browser_artifact_mode=APPLICATIONS_LIST[0],
+    browser=APPLICATIONS_LIST[1],
     mobile_android_artifact_mode=APPLICATIONS_LIST[2],
     mobile_android=APPLICATIONS_LIST[3],
 )
 
 STATE_DIR_INFO = '''
 The Firefox build system and related tools store shared, persistent state
 in a common directory on the filesystem. On this machine, that directory
 is: