Update descriptions for all productivity workloads

Adopt a standard format so that reports can be generated using text directly from these sections of code.

wlauto/workloads/gmail/__init__.py

@@ -29,10 +29,19 @@ class Gmail(AndroidUiAutoBenchmark):
     view = [package+'/com.google.android.gm.ConversationListActivityGmail',
             package+'/com.google.android.gm.ComposeActivityGmail']
     description = """
-    A workload to perform standard productivity tasks within Gmail.
+    A workload to perform standard productivity tasks within Gmail.  The workload carries out
+    various tasks, such as creating new emails and sending them, whilst also producing metrics for
+    action completion times.
 
-    The workload carries out various tasks, such as creating new emails and
+    Test description:
-    sending them, whilst also producing metrics for action completion times.
+
+    1. Open Gmail application
+    2. Click to create New mail
+    3. Enter recipient details in the To: field
+    4. Enter text in the Subject edit box
+    5. Enter text in the Compose edit box
+    6. Attach five images from the local Images folder to the email
+    7. Click the Send mail button
     """
 
     regex = re.compile(r'uxperf_gmail.*: (?P<key>\w+) (?P<value>\d+)')

wlauto/workloads/googlephotos/__init__.py

@@ -30,24 +30,26 @@ class Googlephotos(AndroidUiAutoBenchmark):
             package+'/com.google.android.apps.photos.onboarding.AccountPickerActivity',
             package+'/com.google.android.apps.photos.onboarding.IntroActivity']
     description = """
-    A workload to perform standard productivity tasks with googlephotos.
+    A workload to perform standard productivity tasks with Google Photos.  The workload carries out
+    various tasks, such as browsing images, performing zooms, post-processing and saving a selected
+    image to file.
 
-    The workload carries out various tasks, such as browsing images, performing
+    Although this workload attempts to be network independent it requires a network connection
-    zooms, post-processing and saving a selected image to file.
+    (ideally, wifi) to run. This is because the welcome screen UI is dependent on an existing
+    connection.
 
-    gesture test - browsing through the wa-working gallery using swipe
+    Test description:
-                   gestures and performing pinch gestures for zooming
+    1. Four images are copied to the devices
-    color test   - selects a photograph, increments, resets and decrements color balance
+    2. The application is started in offline access mode
-    crop test    - uses image straightener facility to simultaneously rotate and
+    3. Gestures are performed to swipe between images and pinch zoom in and out of the selected
-                   crop a selected photograph
+       image
-    rotate tests - selects a photograph and performs 90 degree rotations
+    4. The Colour of a selected image is edited by selecting the colour menu, incrementing the
-
+       colour, resetting the colour and decrementing the colour using the seek bar.
-    NOTE: This workload requires four jpeg files to be placed in the
+    5. A Crop test is performed on a selected image.  UiAutomator does not allow the selection of
-    dependencies directory to run.
+       the crop markers so the image is tilted positively, reset and then negatively to get a
-
+       similar cropping effect.
-    Although this workload attempts to be network independent it requires a
+    6. A Rotate test is performed on a selected image, rotating anticlockwise 90 degrees, 180
-    network connection (ideally, wifi) to run. This is because the welcome
+       degrees and 270 degrees.
-    screen UI is dependent on an existing connection.
     """
 
     parameters = [

wlauto/workloads/reader/__init__.py

@@ -30,11 +30,22 @@ class Reader(AndroidUiAutoBenchmark):
             package+'/com.adobe.reader.viewer.ARSplitPaneActivity',
             package+'/com.adobe.reader.viewer.ARViewerActivity']
     description = """
-    A workload to perform standard productivity tasks within Adobe Reader.
+    The Adobe Reader workflow carries out the following typical productivity tasks using
+    Workload-Automation.
 
-    The workload carries out various tasks, such as opening PDF documents,
+    Test description:
-    scrolling and searching through them, whilst also producing metrics for
+
-    action completion times.
+    1. Open the application and sign in to an Adobe Cloud account over wifi
+    2. Select the local files browser list - a test measuring the time taken to navigate through the
+       menus and for the list to be created.
+    3. Search for a specific file from within the - a test measuring the entry of a search string
+       and time taken to locate the document within the file list.
+    4. Open the selected file - a test measuring the time taken to open the document and present
+       within a new view.
+    5. Gestures test - measurement of fps, jank and other frame statistics, via dumpsys, for swipe
+       and pinch gestures.
+    6. Search test - a test measuring the time taken to search a large 100+ page mixed content
+       document for specific strings.  Steps 2-4 are repeated to open the Cortex M4 manual.
     """
 
     parameters = [

wlauto/workloads/skype/__init__.py

@@ -30,17 +30,16 @@ class Skype(AndroidUiAutoBenchmark):
 
     name = 'skype'
     description = '''
-    Workload that makes Skype calls
+    A workload to perform standard productivity tasks within Skype.  The workload logs in to the
+    Skype application, selects a recipient from the contacts list and then initiates a 5 second
+    call.
 
-    It allows for the agenda to decide whether to make a voice call or a video call.
+    Test description:
-    Credentials for the user account used to log into the Skype app have to be provided
+    
-    in the agenda, as well as the display name and skype ID of the contact to call.
+    1. Open Skype application
-
+    2. Log in to a pre-defined account
-    Other optional arguments allow controlling the duration of the call, whether the
+    3. Select a recipient from the Contacts list
-    call includes video or voice only, and whether to collect sys dumps.
+    4. Initiate a 5 second video Call
-
-    For reliable testing, this workload requires a good and stable internet connection,
-    preferably on Wi-Fi.
     '''
     package = 'com.skype.raider'
     view = [package+'/com.skype.android.app.calling.CallActivity',