BLE & WebUSB test updates based on review comments.

Author: microbit-carlos

docs/release-tests/ble-flashing.md

@@ -2,12 +2,12 @@
 
 ## Test preparations
 
-Three hex files needed:
-- "Meet the micro:bit": This is the program that runs on the micro:bit when
+Four hex files needed:
+- "Meet the micro:bit": This is the programme that runs on the micro:bit when
   it is first powered on from factory.
     - Downloadable from the micro:bit website:
       https://microbit.org/get-started/user-guide/meet-the-microbit-program/
-- "Out of Box": The previous factory program before the
+- "Out of Box": The previous factory programme before the
   "Meet the micro:bit" was released.
     - Downloadable from the micro:bit website:
       https://microbit.org/get-started/user-guide/meet-the-microbit-program/
@@ -22,18 +22,29 @@ Three hex files needed:
 
 Two mobile/tablet devices needed:
 - Android device with the micro:bit app installed.
-    - To load a different MakeCode URL long touch the micro:bit logo in the
-      app main screen and a modal will appear with the option change
+    - To load a different MakeCode URL, long touch the micro:bit logo in the
+      app main screen and a modal will appear with the option to change
 - iOS device with the micro:bit app installed.
-    - To load a different MakeCode URL long press the MakeCode back chevron
+    - To load a different MakeCode URL, long press the MakeCode back chevron
       to choose beta.
 
-## Test 1: Full flashing with Bluetooth from "Out of Box" and "Meet the micro:bit"
+Two micro:bits needed:
+- micro:bit V1
+- micro:bit V2
+
+The micro:bits can be powered via USB for these tests, as that avoids any
+possible issues or errors due to low batteries.
+
+## Test 1: Full & partial flashing with Bluetooth
 
 This test should be carried out with:
 - Android app
 - iOS app
 
+And the following micro:bit versions:
+- micro:bit V1
+- micro:bit V2
+
 A test run for each of these hex files is required:
 - "Out of Box" hex file
 - "Meet the micro:bit" hex file
@@ -43,36 +54,23 @@ A test run for each of these hex files is required:
 Steps:
 1. Connect the micro:bit to the computer via USB.
 2. Copy the hex file under test to the `MICROBIT` USB drive.
-3. Disconnect the micro:bit from the computer and connect a battery pack.
-4. Open the app and load the MakeCode editor under tests.
-    - Instructions will be added soon.
-5. Create a new MakeCode project with a simple program (e.g. display
+3. Open the app and load the MakeCode editor under test.
+    - From the front page, select "Create Code"
+4. Create a new MakeCode project with a simple programme (e.g. display
    something on the LED matrix).
-6. Click the "Download" button.
-7. Follow the connection instructions to connect the micro:bit via Bluetooth
-   and download the program.
-8. Verify that the program runs on the micro:bit.
-
-## Test 2: Partial flashing
-
-Test 1 has to be performed inmediately before this test to ensure the micro:bit
-is in a known state.
-
-This test should be carried out with:
-- Android app
-- iOS app
-
-Steps:
-1. Follow steps from Test 1.
-2. Change the blocks in the MakeCode editor to do something different
+    - If a programme has already been created from a previous test run,
+      it can be reused.
+5. Tap the "Download" button and follow the instructions to connect the
+   micro:bit via Bluetooth and flash the programme.
+6. Verify the programme is running on the micro:bit.
+7. Change the blocks in the MakeCode editor to do something different
    (e.g. display a different icon/message on the LED matrix).
-3. Click the "Download" button.
-4. Follow the connection instructions to connect the micro:bit via Bluetooth
-   and download the program.
-5. Verify the BLE flashing process was shorter than on Test 1.
-6. Verify that the program runs on the micro:bit.
+8. Tap the "Download" button and follow the instructions to flash the programme.
+9. Confirm the BLE flashing process was shorter than the initial download from
+   step 5.
+10. Verify that the new programme is running on the micro:bit.
 
-## Test 3: Utility Service
+## Test 2: Utility Service
 
 This test checks that the Utility Service is available and working on
 the builds of the MakeCode editor under test.
@@ -81,6 +79,9 @@ This test should be carried out with:
 - Android app
 - iOS app
 
+And the following micro:bit versions:
+- micro:bit V2 only
+
 Steps:
 1. Flash the micro:bit with this MakeCode programme, using any method:
     ```javascript
@@ -89,10 +90,11 @@ Steps:
         datalogger.createCV("y", input.acceleration(Dimension.Y)),
         datalogger.createCV("x", input.acceleration(Dimension.X))
         )
+        basic.pause(100)
     })
     ```
 2. Open the micro:bit app, go to "My Programs".
 3. Tap on the "Fetch MY_DATA (V2 only)" button and follow the instructions
    to connect the micro:bit via Bluetooth.
-4. Verify that the data a table of Time, X and Y acceleration values
+4. Verify that the data as a table of Time, X and Y acceleration values
    is shown in the app.

docs/release-tests/webusb.md

@@ -56,28 +56,32 @@ it is acceptable to use an existing project created in a previous test run.
 ### Test 1: WebUSB full flash, partial flash, and serial
 
 1. Connect the micro:bit to the computer via USB.
-2. Open the micro:bit MakeCode editor under test in a Chrome-based browser.
-3. Create a new project, and add a block to display an icon on the LED matrix.
-4. If the micro:bit was automatically connected via WebUSB, disconnect it from
+2. Flash a hex file that has not been generated by the MakeCode editor under
+   test.
+    - For example, the "Meet the micro:bit" hex file from:
+      https://microbit.org/get-started/user-guide/meet-the-microbit-program/
+3. Open the micro:bit MakeCode editor under test in a Chrome-based browser.
+4. Create a new project, and add a block to display an icon on the LED matrix.
+5. If the micro:bit was automatically connected via WebUSB, disconnect it from
    the editor by clicking on the "Disconnect" button in "Download" menu
    (three dots icon at the right of the "Download" button).
-5. Click the "Download" button.
-6. Follow the connection instructions to connect the micro:bit via WebUSB and
+6. Click the "Download" button.
+7. Follow the connection instructions to connect the micro:bit via WebUSB and
    download the programme.
-7. Verify that the programme runs on the micro:bit.
-8. Change the code to this one:
+8. Verify that the programme runs on the micro:bit.
+9. Change the code to this one:
     ```javascript
     basic.forever(function () {
         serial.writeLine("hello")
         basic.pause(1000)
     })
     ```
-9. Click the "Download" button again.
-10. No connection instructions should be shown this time and the programme
+10. Click the "Download" button again.
+11. No connection instructions should be shown this time and the programme
     should be downloaded directly to the micro:bit in a shorter amount of time.
-11. A "Show Data Device" button should appear, click it to open the serial
+12. A "Show Data Device" button should appear, click it to open the serial
     console.
-12. Verify that the serial console shows "hello" every second.
+13. Verify that the serial console shows "hello" every second.
 
 ## Tests on specific variations