QA/Photon Onboarding Tour Overlay

From MozillaWiki
Jump to navigation Jump to search

Revision History

This section describes the modifications that have been made to this wiki page. A new row has been completed each time the content of this document is updated (small corrections for typographical errors do not need to be recorded). The description of the modification contains the differences from the prior version, in terms of what sections were updated and to what extent.

Date Version Author Description
06/21/2017 1.0 Justin Williams Created first draft
07/03/2017 1.1 Justin Williams Edits to draft
08/14/2017 1.2 Justin Williams Edits to draft (added V2 information)

Overview

Purpose

Gives a new user/user that has not used Firefox in a while a description and an introduction to Firefox's new innovative features, such as:

V1

  • Private Browsing
  • Addons
  • Customize
  • One-Click Search
  • Default Browser
  • Sync

V2 New User

  • Performance
  • Private Browsing
  • Screenshots
  • Add-ons
  • Customize
  • Default Browser

V2 Updated User

  • Performance
  • Library
  • Address Bar
  • Customize
  • Sync

with a overlay that is accessed by clicking the fox head on the about:newtab page or the default about:home page. The overlay is also accessed by clicking the Onboarding Tour Notification.

Ownership

Engineering lead
  Tim Chien
Engineering Team
  Fred Lin
  Fischer Liu
  Rex Lee
UX Team: 
  Michael Verdi
  Bryant Mao
QA 
  Justin Williams

Testing summary

Scope of Testing

In Scope

1. Profile Refresh
2. Onboarding Tour Overlay which includes:

V1

  • Performance
  • Private Browsing
  • Screenshots
  • Add-ons
  • Customize
  • Default Browser
  • Library
  • Address Bar
  • Sync

V2

  • Performance
  • Private Browsing
  • Screenshots
  • Add-ons
  • Customize
  • Default Browser
  • Library
  • Address Bar
  • Sync

These features above are shown in the overlay to give the user a walk through/introduction of Firefox’s innovative features.

Out of Scope

Everything that does not include the features in scope, about:newtab, about:home, profile refresh, and the hamburger menu. Fennec is also out of scope.

Requirements for testing

Environments

Windows 7 x64: Intel(R) Core(TM) i5-47900 CPU @ 3.60GHz 3.59 GHz
Windows 10 x64: Intel(R) Core(TM) i7-4790 CPU @ 3.60GHz, 3601 Mhz
Ubuntu 17.04 x64:Intel(R) Core(TM) i5-7500 CPU @ 3.40GHz
Mac 10.12 x64: 2.7 GHz Intel Core i5

Test Strategy

Risk Assessment and Coverage

ID Description / Threat Description Covered by Test Objective Magnitude Probability Priority Impact Score
RAC-1 User is irritated by not being able to quickly dismiss the onboarding overlay TO-1 2-Moderate 1-Unlikely 1-Low 2
RAC-2 Tour overlay shows when updating from 55 to 56 (Tour will show for update from 56 to 57) TO-2 3-High 2-Possible 3-High 18

Values:

  • Magnitude: 1- Low , 2-Moderate, 3-High
  • Probability: 1-Unlikely, 2-Possible, 3-Almost Certain
  • Priority: 1 - Low, 2-Medium, 3-High

Impact Score Breakdown:

  • An impact value of 1, 2, 3, 4 would describe an area which although should be covered there aren't expected any discoveries of critical issues.
  • An impact value of 6, 8, 9, 12 would describe an area in which we expect to find issues but those issues are not expected to be critical.
  • An impact value of 18 or 27 would describe an area on which it is likely to find issues and those issues to be critical or blockers.

Test Objectives

This section details the progression test objectives that will be covered. Please note that this is at a high level. For large projects, a suite of test cases would be created which would reference directly back to this master. This could be documented in bullet form or in a table similar to the one below.

Ref Function Test Objective Evaluation Criteria Test Type RAC Owners
1 Click outside of tour overlay Tour overlay closes when user clicks out of tour overlay The tour overlay successfully closes when the user clicks out of the tour overlay Manual RAC-1 Eng Team
2 Updating Firefox Updates to Firefox show the tour overlay only when user updates from a version less than 55 to 56. (Tour will show when updating from 56 to 57) The tour overlay is not shown when the user updates from 55 to 56. The tour overlay is shown when the user updates from 54 to 56 or 56 to 57. Manual RAC-2, RAC-3 Eng Team

Test Execution Schedule

The following table identifies the anticipated testing period available for test execution.

Project phase Start Date End Date
Start project 03/30/1017 11/14/2017
Study documentation/specs received from developers 03/30/2017 08/05/2017
QA - Test plan creation 06/21/2017 11/14/2017
QA - Test cases/Env preparation 07/14/2017 11/14/2017
QA - Nightly Testing V1 07/20/2017 07/25/2017
QA - Beta Testing V1
Release Date V1
QA - Nightly Testing V2 08/18/2017 08/24/2017
QA - Beta Testing V2
Release Date V2 11/14/2017 11/14/2017

Testing Tools

Detail the tools to be used for testing, for example see the following table:

Process Tool
Test plan creation Mozilla wiki
Test case creation V1 Onboarding Test Case Creation V1
Test case execution V1 Onboarding Test Case Execution V1
Test case creation V2 Onboarding Test Case Creation V2
Test case execution V2 Onboarding Test Case Execution V2
Bugs management Overlay Meta Bug

Status

Overview

Track the dates and build number where feature was merged to Release/Beta

Channel Date feature was merged to channel Build number
Nightly V1 07/25/2015 20170725030209
Beta V1 08/10/2017 20170810180547
Release V1
Nightly V2 08/18/2017 20170818100226
Beta V2
Release V2

References

Testcases

Test Areas

Test Areas Covered Details Reviewed By
Private Window Y have to manually type in about:newtab or about:home TPE Eng Team
Multi-Process Enabled Y enabled by default which effects majority of the users TPE Eng Team
Theme (high contrast) Y not all images will be shown bug 1377439 TPE Eng Team
UI
Mouse-only operation Y used by majority of the users TPE Eng Team
Keyboard-only operation Y accessibility issues are P3 bug 1377300 TPE Eng Team
Display (HiDPI) Y verify that the overlay is shown correctly TPE Eng Team
Interaction (scroll, zoom) Y effects the tour overlay bug 1381010 TPE Eng Team
Usable with a screen reader Y accessibility issues are P3 bug 1377300 TPE Eng Team
Usability and/or discoverability testing Y TPE Eng Team
RTL build testing Y rtl issues are P1 bug 1375024 TPE Eng Team
Install/Upgrade
Feature upgrades/downgrades data as expected Y bug 1377470 TPE Eng Team
Does sync work across upgrades Y if user in 56 is in a signed status and updates to 57, we should detect it. TPE Eng Team
Requires install testing Y stub installer refreshes profile on windows if the user is 2 versions lower than 57 and will not restore the session bug 1369255, bug 1376558 TPE Eng Team
Affects first-run or onboarding Y stub installer refreshes profile on windows if the user is 2 versions lower than 57 and will not restore the session bug 1369255, bug 1376558 TPE Eng Team
Does this affect partner builds? Partner build testing Y browser.onboarding.enabled defaulted on TPE Eng Team
Data Monitoring
Temporary or permanent telemetry monitoring Y will not be in 56 but may be in 57 TPE Eng Team
Telemetry correctness testing Y will not be in 56 but may be in 57 TPE Eng Team
Interoperability
Interaction of this feature with other browser features Y Private Browsing, Sync TPE Eng Team

Test suite

Full Test suite - Onboarding Test Suite V1
Full Test suite - Onboarding Test Suite V2

Bug Work

Meta bug: 1354046 - bug summary

Logged bugs ( blocking 1354046 )
Full Query
ID Priority Component Assigned to Summary Status Target milestone
1322738 -- New Tab Page Dão Gottwald [:dao] Update about:newtab tile shapes / organization to match activity stream VERIFIED Firefox 53
1350205 P3 New Tab Page Clean up the look of the new tab compact tiles RESOLVED ---
1354707 P1 General Verdi [:verdi] Best to slack me [UX] New User Tour Overlay UX Specs VERIFIED Firefox 55
1356152 -- General [User Story] [Overlay] As a user, I want to know the purpose of the fox icon on my new tab page RESOLVED ---
1356168 P1 General [User Story] [Overlay] As a user, I want to open and close the overlay VERIFIED ---
1356175 P1 General [User Story] [Overlay] As a user, I want to make the fox icon go away so that my new tab looks clean VERIFIED ---
1356180 P1 General [User Story] [Overlay] As Firefox team, we want to keep the overlay flexible for future / different tours VERIFIED ---
1356473 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn the benefit of "Firefox Sync" VERIFIED ---
1356479 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn what I can do with "Add-ons" VERIFIED ---
1356486 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn how to Customize Firefox VERIFIED ---
1356487 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn the benefit of "Private Browsing" VERIFIED ---
1356488 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn how to make Firefox my "Default Browser" VERIFIED ---
1358970 P3 General Tim Guan-tin Chien [:timdream] (please needinfo) The onBoarding overlay should be responsive to difference window sizes VERIFIED Firefox 56
1365531 P2 New Tab Page Display next unchecked tour when click the fox icon RESOLVED Firefox 57
1365547 P2 New Tab Page Display onboarding overlay on activity stream RESOLVED Firefox 57
1367696 P1 New Tab Page gasolin@mozilla.com show new user / updating user tour VERIFIED Firefox 56
1367698 P2 New Tab Page [Meta] add tours set for Firefox 57 VERIFIED Firefox 57
1369291 P1 New Tab Page gasolin@mozilla.com add l10n support for onboarding overlay VERIFIED Firefox 56
1370459 P1 General gasolin@mozilla.com Polish the onboarding overlay UI to align with new visual spec VERIFIED Firefox 56
1371201 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) The mozilla icon at top of about:home should be shown at left-top under RTL languages VERIFIED Firefox 56
1371537 P5 New Tab Page Hover on fox icon and the fox will wink the eye RESOLVED ---
1373303 P5 New Tab Page Open One Click Search doesn't do anything when user removed the search bar in the toolbar NEW ---
1373612 P1 General Only upper half of the button can be clicked in onboarding tours. RESOLVED ---
1373731 -- General Onboarding layout is broken if labels on left column don't fit on one line RESOLVED ---
1373734 -- General Inconsistencies between onboarding wording and highlighted menus RESOLVED ---
1374496 P1 New Tab Page gasolin@mozilla.com Search suggestions tip overlaps the onboarding fox icon RESOLVED Firefox 56
1374544 P5 General Inconsistent onboarding experience depending on if a user accesses the tour from about:home or about:newtab NEW Firefox 56
1375793 P1 New Tab Page gasolin@mozilla.com Shipping onboarding overlay to all versions VERIFIED Firefox 56
1377470 P1 New Tab Page gasolin@mozilla.com Updated users still see new user tour after bug 1367696 lands VERIFIED Firefox 56
1378772 P5 New Tab Page User is able to enter an email address in new onboarding tour even after the user has already signed into Sync. NEW ---
1381360 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) Make the speech bubbles 3px to the right of the fox icons VERIFIED Firefox 56
1381368 P5 General Should switch to AsyncPrefs.jsm from Preferences.jsm for the Onboarding tour NEW ---
1381377 P5 New Tab Page Fischer [:Fischer] Do preference check before loading onboarding.js RESOLVED ---
1381716 P2 General The Onboarding tour should also detect the url of the activity-stream page for display RESOLVED ---
1381765 P1 New Tab Page gasolin@mozilla.com Should show the first uncomplete tour by default VERIFIED Firefox 56
1382510 P1 New Tab Page gasolin@mozilla.com update Private Browsing overlay and notification description VERIFIED Firefox 56
1382565 P5 General The word spacing is too large when display the character " ' " NEW ---
1383660 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) speech bubble of Onboarding icon should be clickable VERIFIED Firefox 56
1384841 P1 Tours KM Lee [:rexboy] (inactivate after Sep. 22) Match the style of the UITour highlights with Photon style guide VERIFIED Firefox 57
1385123 P3 New Tab Page KM Lee [:rexboy] (inactivate after Sep. 22) [Onboarding] Default browser list item has word wrapping when selected/hovered for some locales VERIFIED Firefox 57
1389558 P5 New Tab Page In the tour overlay "Open Default Browser Settings" is not clickable again if it is clicked once RESOLVED ---
1395946 -- New Tab Page Tour overlay may be accidentally dismissed if visiting some of the sections RESOLVED ---
1395953 P5 New Tab Page Search panel is not displayed correctly when the panel moved to the menu NEW ---
1397266 -- New Tab Page [Overlay] The Sync progress is checked even if the sign up process was not (properly) completed RESOLVED ---
1397828 -- New Tab Page [Overlay] The Default Browser progress is checked even if the related setting is not changed RESOLVED ---

45 Total; 6 Open (13.33%); 15 Resolved (33.33%); 24 Verified (53.33%);


Bug fix verification
Full Query
ID Priority Component Assigned to Summary Status Resolution Target milestone
1322738 -- New Tab Page Dão Gottwald [:dao] Update about:newtab tile shapes / organization to match activity stream VERIFIED FIXED Firefox 53
1354707 P1 General Verdi [:verdi] Best to slack me [UX] New User Tour Overlay UX Specs VERIFIED FIXED Firefox 55
1356152 -- General [User Story] [Overlay] As a user, I want to know the purpose of the fox icon on my new tab page RESOLVED FIXED ---
1356168 P1 General [User Story] [Overlay] As a user, I want to open and close the overlay VERIFIED FIXED ---
1356175 P1 General [User Story] [Overlay] As a user, I want to make the fox icon go away so that my new tab looks clean VERIFIED FIXED ---
1356180 P1 General [User Story] [Overlay] As Firefox team, we want to keep the overlay flexible for future / different tours VERIFIED FIXED ---
1356473 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn the benefit of "Firefox Sync" VERIFIED FIXED ---
1356479 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn what I can do with "Add-ons" VERIFIED FIXED ---
1356486 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn how to Customize Firefox VERIFIED FIXED ---
1356487 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn the benefit of "Private Browsing" VERIFIED FIXED ---
1356488 P1 General [User Story] [Overlay] [Tour Experiment] As a user, I want to learn how to make Firefox my "Default Browser" VERIFIED FIXED ---
1358970 P3 General Tim Guan-tin Chien [:timdream] (please needinfo) The onBoarding overlay should be responsive to difference window sizes VERIFIED FIXED Firefox 56
1367696 P1 New Tab Page gasolin@mozilla.com show new user / updating user tour VERIFIED FIXED Firefox 56
1367698 P2 New Tab Page [Meta] add tours set for Firefox 57 VERIFIED FIXED Firefox 57
1369291 P1 New Tab Page gasolin@mozilla.com add l10n support for onboarding overlay VERIFIED FIXED Firefox 56
1370459 P1 General gasolin@mozilla.com Polish the onboarding overlay UI to align with new visual spec VERIFIED FIXED Firefox 56
1371201 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) The mozilla icon at top of about:home should be shown at left-top under RTL languages VERIFIED FIXED Firefox 56
1373731 -- General Onboarding layout is broken if labels on left column don't fit on one line RESOLVED FIXED ---
1375793 P1 New Tab Page gasolin@mozilla.com Shipping onboarding overlay to all versions VERIFIED FIXED Firefox 56
1377470 P1 New Tab Page gasolin@mozilla.com Updated users still see new user tour after bug 1367696 lands VERIFIED FIXED Firefox 56
1381360 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) Make the speech bubbles 3px to the right of the fox icons VERIFIED FIXED Firefox 56
1381765 P1 New Tab Page gasolin@mozilla.com Should show the first uncomplete tour by default VERIFIED FIXED Firefox 56
1382510 P1 New Tab Page gasolin@mozilla.com update Private Browsing overlay and notification description VERIFIED FIXED Firefox 56
1383660 P1 General KM Lee [:rexboy] (inactivate after Sep. 22) speech bubble of Onboarding icon should be clickable VERIFIED FIXED Firefox 56
1384841 P1 Tours KM Lee [:rexboy] (inactivate after Sep. 22) Match the style of the UITour highlights with Photon style guide VERIFIED FIXED Firefox 57
1385123 P3 New Tab Page KM Lee [:rexboy] (inactivate after Sep. 22) [Onboarding] Default browser list item has word wrapping when selected/hovered for some locales VERIFIED FIXED Firefox 57

26 Total; 0 Open (0%); 2 Resolved (7.69%); 24 Verified (92.31%);

Sign off

Criteria

Checklist

  • All test cases should be executed
  • Has sufficient automated test coverage (as measured by code coverage tools) - coordinate with RelMan
  • All blockers, criticals must be fixed and verified or have an agreed-upon timeline for being fixed (as determined by engineering/RelMan/QA)

Results

Nightly testing V1

List of OSes that will be covered by testing
Win 7 & 10, Ubuntu 16.04, and Mac 10.12


Merge to Beta Sign-off V1

List of OSes that will be covered by testing
Win 7 & 10, Ubuntu 16.04, and Mac 10.12

  • Link for the tests run
    • Full Test suite

Nightly testing V2

List of OSes that will be covered by testing
Win 7 & 10, Ubuntu 16.04, and Mac 10.12


Merge to Beta Sign-off V2

List of OSes that will be covered by testing
Win 7 & 10, Ubuntu 16.04, and Mac 10.12

  • Link for the tests run
    • Full Test suite

Checklist

Exit Criteria Status Notes/Details
Testing Prerequisites (specs, use cases) [DONE] Specs
Testing Infrastructure setup [DONE]
Test Plan Creation [DONE]
Test Cases Creation [DONE]
Automation Coverage N/A
Performance Testing N/A
All Defects Logged IN PROGRESS
Critical/Blockers Fixed and Verified IN PROGRESS
Metrics/Telemetry IN PROGRESS
Basic/Core functionality Nightly testing V1 [DONE]
QA mid-Nightly Signoff V1 [DONE] Email Sent
QA Nightly - Full Testing V1 [DONE] Test Results
QA pre-Beta Signoff V1 [DONE] Email Sent
QA Beta - Full Testing V1
QA pre-Release Signoff V1 Email to be sent
Basic/Core functionality Nightly testing V2 IN PROGRESS
QA mid-Nightly Signoff V2 IN PROGRESS Email to be sent
QA Nightly - Full Testing V2
QA pre-Beta Signoff V2 Email to be sent
QA Beta - Full Testing V2
QA pre-Release Signoff V2 Email to be sent

Approvals Required / Received

The following individuals are required to/have approved this Test Plan:

Name Title Department Approval Date Method
Lawrence Mandel / RyanVM QA Reviewer Product Integrity Email
Tim Chien Software Engineer Engineering Email
Marco Mucci EPM Product Management Email