View source for QA/One-off Searches From Awesomebar

'''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.

{| class="wikitable" style="width:60%"
|-
! Date !! Version !! Author !! Description 
|-
| 08/18/2016 || 1.0 || Brindusa Tot || Created first draft
|-
| || || || 
|}

= Overview =
== Purpose ==
Detail the purpose of this document. For example:
* The test scope, focus areas and objectives
* The test responsibilities
* The test strategy for the levels and types of test for this release
* The entry and exit criteria
* The basis of the test estimates
* Any risks, issues, assumptions and test dependencies
* The test schedule and major milestones
* The test deliverables

== Scope ==
This wiki details the testing that will be performed by the project team for the '''One-off searches from Awesomebar''' feature. It defines the overall testing requirements and provides an integrated view of the project test activities. Its purpose is to document:
* Verify that One-Off Searches engine are displayed at bottom of Awesomebar
* Verify that One-Off Searches buttons functions correctly, similar with the ones from Searchbar

== Ownership ==
'''<big>Development</big>'''<br />
Manager: [mailto:pastithas@mozilla.com Panagiotis Astithas] (irc: past)<br />
Developer contacts: [mailto:adw@mozilla.com Drew Willcoxon] (irc: adw)

'''<big>Engineering Team</big> - Nightly Testing''':<br /> 
[mailto:rares.bologa@softvisioninc.eu Rares Bologa] (irc: RaresB) - PM for QA team <br />
[mailto:brindusa.tot@softvisioninc.eu Brindusa Tot] (irc: brindusat) - leading QA efforts <br />
[mailto:simona.marcu@softvision.ro Simona Badau] (irc: simonab) - QA <br />
[mailto:roxana.leitan@softvision.ro Roxana Leitan] (irc: RoxanaLeitan) - QA<br />

= Testing summary = 
== Scope of Testing ==
=== In Scope ===

One-Off Searches From Awesomebar is a Mozilla feature that aims to help users with search directly from location/awesome bar using the already defined search engines. 
The testing effort for the One-Off Searches Awesomebar  will be invested in the following areas:

* functionality: basic and advanced functionality to be verified according to the existing requirements;
* usability: the One-Off Searches from Awesomebar feature must be easy to use and straightforward;
* accessibility: the One-Off Searches from Awesomebar feature can be used with High Contrast Theme, Keyboard only or Screen Reader;

=== Out of Scope ===
Testing of other functionalities of Awesome bar are not related to search are not in the interest of testing for this feature.

= Requirements for testing =
== Environments ==
Full testing will be performed on the following OSes:

* Windows, probably Windows 7 and Windows 10
* Mac OS X
* Ubuntu


Other configuration/environmental setup needed:

* In Firefox configuration settings browser.urlbar.oneOffSearches preference needs to be set to true.

= Test Strategy = 
== 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.

{| class="wikitable"
|-
! Ref !! Function !! Test Objective !! Evaluation Criteria !! Test Type !! Owners 
|-
| 1 || One-off searches  bar display || One off searches bar is displayed || One off searches bar is displayed at bottom of Awesomebar with all search engines defined by user|| Manual || Eng Team
|-
| 2 || One-off searches  bar - search functionality || One off searches buttons functions correctly || All search buttons from One-Off searches bar are working correctly || Manual || Eng Team
|-
| 3 || Accessibility || One off searches from Awesomebar is visible and usable from accessibility point of view	 || 	Testing for accessibility includes: <br />
- testing using high Contract themes <br />
- Screen Reader validation<br />
- Keyboard-only 
|| Manual || Eng Team
|-
| 4 || Upgrade-Downgrade || One off searches from Awesomebar behavior at FF Ugrade/Downgrade || One-Off searches Awesomebar buttons are not lost during FF upgrade/downgrade || Manual || Eng Team
|}

== Builds ==
This section should contain links for builds with the feature 
* Links for Nightly builds: 
** First Landed on Nightly 51.0a1: [http://archive.mozilla.org/pub/firefox/nightly/2016/08/2016-08-04-03-04-41-mozilla-central/ link ] on 08.04.2016

* Links for Beta builds

== Test Execution Schedule ==
The following table identifies the anticipated testing period available for test execution.
{| class="wikitable" style="width:60%"
|-
! Project phase !! Start Date !! End Date
|-
| Start project 
|style="text-align:center;" | 2016.08.17  
|style="text-align:center;" |  TBD  
|-
| Study documentation/specs received from developers
|style="text-align:center;" | 2016.08.17 
|style="text-align:center;" | 2016.08.18 
|-
| QA - Test plan creation 
|style="text-align:center;" | 2016.08.18 
|style="text-align:center;" | 2016.08.23
|-
| QA - Nightly Testing 
|style="text-align:center;" | 2016.08.23
|style="text-align:center;" |     
|-
| QA - Beta Testing 
|style="text-align:center;" |  || 
|-
| Release Date 
|style="text-align:center;" | || 
|}

== Testing Tools ==
Detail the tools to be used for testing, for example see the following table:
{| class="wikitable" style="width:50%"
|-
! Process !! Tool
|-
| Test plan creation || Mozilla wiki
|-
| Test case creation || [https://testrail.stage.mozaws.net/index.php TestRail]/ Google docs
|-
| Test case execution || [https://testrail.stage.mozaws.net/index.php TestRail]
|-
| Bugs management || Bugzilla
|}

= Status = 
== Overview ==
* Landed on Nightly:
** First Landed on Nightly 51.0a1: [http://archive.mozilla.org/pub/firefox/nightly/2016/08/2016-08-04-03-04-41-mozilla-central/ link ] on 08.04.2016
** At merge with Aurora, the feature was not sign-off to Aurora due to a large number of bugs opened on this feature. Feature remains disabled on Aurora 51 and enabled on Nightly 52
** The feature also missed the Firefox 52, 53 and 54 releases, due to the large number of issues, work was re-prioritized in [https://bugzilla.mozilla.org/show_bug.cgi?id=1337003 Bug 1337003]

== Risk analysis ==
* Awesomebar functionality/performance might be affected by One-off searches buttons from Awesomebar.

= References =
* Meta bugs:
** [https://bugzilla.mozilla.org/show_bug.cgi?id=1180944 1180944 - Implement one-off searches from Awesomebar ]<br />
** [https://bugzilla.mozilla.org/show_bug.cgi?id=1337003 1337003 - META - One-off buttons in urlbar blockers]

* List and links for specs
  - Useful info about Awesomebar search at [https://support.mozilla.org/en-US/kb/awesome-bar-search-firefox-bookmarks-history-tabs link]

= Testcases = 
Full test suites can be found on TestRail at [https://testrail.stage.mozaws.net/index.php?/suites/view/130&group_by=cases:section_id&group_order=asc link] or in the [https://wiki.mozilla.org/images/b/b9/One-off_searches_from_Awesomebar_-EngQA-_-_TestRail.pdf PDF doc] (last update made - 2017-05-10)

== Test Areas ==
{| class="wikitable" style="width:80%"
|-
! Test Areas !! Covered !! Details
|-
| Private Window 
|style="text-align:center;" | Yes || 
|-
| Multi-Process Enabled 
|style="text-align:center;" | Yes || 
|-
| Multi-process Disabled 
|style="text-align:center;" | No || 
|-
| Theme (high contrast) 
|style="text-align:center;" | Yes || 
|-
| '''UI''' 
||  || 
|-
| Mouse-only operation  
|style="text-align:center;" | Yes || 
|-
| Keyboard-only operation  
|style="text-align:center;" | Yes ||
|-
| Display (HiDPI) 
|style="text-align:center;" | Yes || 
|-
| Interraction (scroll, zoom) 
|style="text-align:center;" | Yes || 
|-
| Usable with a screen reader  
|style="text-align:center;" | Yes || e.g. with NVDA
|-
| Usability and/or discoverability testing   
|style="text-align:center;" | Yes || Is this feature user friendly

|-
| '''Help/Support''' 
||  || 
|-
| Help/support interface required   
|style="text-align:center;" | No || Make sure link to support/help page exist and is easy reachable.
|-
| Support documents planned(written)  
|style="text-align:center;" | ? || Make sure support documents are written and are correct.

|-
| '''Install/Upgrade''' 
||  || 
|-
| Feature upgrades/downgrades data as expected   
|style="text-align:center;" | Yes ||
|-
| Does sync work across upgrades   
|style="text-align:center;" | No || 
|-
| Requires install testing    
|style="text-align:center;" | No || separate feature/application installation needed (not only Firefox)
|-
| Affects first-run or onboarding     
|style="text-align:center;" | NA  || Florin/Lawrence are investigating if there is a dedicated QA for this, or we should test? Should be an yes/no and if is yes should add in detail column the team/person assigned.
|-
| Does this affect partner builds? Partner build testing  
|style="text-align:center;" | NA || yes/no options, add comment with details about who will lead testing

|-
| ''' Enterprise ''' 
||  ||  Raise up the topic to developers to see if they are expecting to work different on ESR builds
|-
| Enterprise administration   
|style="text-align:center;" | No || 
|-
| Network proxies/autoconfig   
|style="text-align:center;" | No || 
|-
| ESR behavior changes   
|style="text-align:center;" | No || 
|-
| Locked preferences  
|style="text-align:center;" | No ||

|-
| ''' Data Monitoring ''' 
||  || 
|-
| Temporary or permanent telemetry monitoring   
|style="text-align:center;" | Yes || List of error conditions to monitor
|-
| Telemetry correctness testing   
|style="text-align:center;" | No || 
|-
| Server integration testing   
|style="text-align:center;" | No || 
|-
| Offline and server failure testing   
|style="text-align:center;" | No ||
|-
| Load testing   
|style="text-align:center;" | No ||

|-
| ''' Add-ons ''' 
||  || If add-ons are available for testing feature, or is current feature will affect some add-ons, then API testing should be done for the add-on.
|-
| Addon API required?   
|style="text-align:center;" | No || 
|-
| Comprehensive API testing   
|style="text-align:center;" | No || 
|-
| Permissions   
|style="text-align:center;" | No || 
|-
| Testing with existing/popular addons
|style="text-align:center;" | No || 

|-
| ''' Security ''' 
||  || Security is in charge of Matt Wobensmith. We should contact his team to see if security testing is necessary for current feature.
|-
| 3rd-party security review   
|style="text-align:center;" | No || 
|-
| Privilege escalation testing
|style="text-align:center;" | No || 
|-
| Fuzzing   
|style="text-align:center;" | No || 

|-
| ''' Web Compatibility ''' 
||  || depends on the feature
|-
| Testing against target sites   
|style="text-align:center;" | No || 
|-
| Survey of many sites for compatibility   
|style="text-align:center;" | No || 

|-
| ''' Interoperability  ''' 
||  || depends on the feature
|-
| Common protocol/data format with other software: specification available. Interop testing with other common clients or servers.   
|style="text-align:center;" | No || 
|-
| Coordinated testing/interop across the Firefoxes: Desktop, Android, iOS   
|style="text-align:center;" | No || 
|-
| Interaction of this feature with other browser features   
|style="text-align:center;" | No || 
|}

== Test suite ==
 Full Test suite - can be found on TestRails at  [https://testrail.stage.mozaws.net/index.php?/suites/view/130&group_by=cases:section_id&group_order=asc link]

= Bug Work =
Tracking bugs:
* [https://bugzilla.mozilla.org/show_bug.cgi?id=1180944 meta bug 1180944]

== Logged bugs ( blocking [https://bugzilla.mozilla.org/show_bug.cgi?id=1180944 1180944] ) ==
<bugzilla>
    {
        "blocks":[1180944],
        "include_fields": "id, priority, component, assigned_to, summary, status, target_milestone"
    }
</bugzilla>

== Bug Verification  (blocking [https://bugzilla.mozilla.org/show_bug.cgi?id=1180944 1180944]) ==
<bugzilla>
    {
        "blocks":[1180944],
        "resolution":"FIXED",
        "include_fields": "id, priority, component, assigned_to, summary, status, target_milestone"
    }
</bugzilla>

* [https://bugzilla.mozilla.org/show_bug.cgi?id=1337003 meta bug 1337003]

== Logged bugs ( blocking [https://bugzilla.mozilla.org/show_bug.cgi?id=1337003 1337003] ) ==
<bugzilla>
    {
        "blocks":[1337003],
        "include_fields": "id, priority, component, assigned_to, summary, status, target_milestone"
    }
</bugzilla>

== Bug Verification  (blocking [https://bugzilla.mozilla.org/show_bug.cgi?id=1337003 1337003]) ==
<bugzilla>
    {
        "blocks":[1337003],
        "resolution":"FIXED",
        "include_fields": "id, priority, component, assigned_to, summary, status, target_milestone"
    }
</bugzilla>

= Sign off =
== Criteria ==
Check list
* All test cases should be executed
* 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'''<br />

Testing will be performed on folowing OSes<br />
* Windows 7<br />
* Windows 10<br />
* Ubuntu 14.04<br />
* Mac OS X 10.10<br />
<br />

Link for the tests run
* Full Test suite, at [https://testrail.stage.mozaws.net/index.php?/plans/view/298 link]
* Regression Test suite, if needed/available
<br />

'''Merge to Aurora Sign-off'''<br />

List of OSes that will be covered by testing<br />
*Link for the tests run
** Full Test suite

== Checklist ==
{| class="wikitable" style="width:80%"
|-
! Exit Criteria !! Status !! Notes/Details
|-
|  Testing Prerequisites (specs, use cases) 
| style="text-align:center;" |   {{mdone|}}
| style="text-align:center;" | 
|-
|  Testing Infrastructure setup 
|style="text-align:center;" |  {{mdone|}} || 
|-
|  Test Plan Creation 
| style="text-align:center;" | {{mdone|}}  || 
|-
|  Test Cases Creation 
|style="text-align:center;" | {{mdone|}}  || 
|-
|  Full Functional Tests Execution 
|style="text-align:center;" |  {{mprog|}}
|style="text-align:center;" |  
|-
|  Automation Coverage
|style="text-align:center;" |  {{mdone|}}
|style="text-align:center;" |  Covered by test: https://dxr.mozilla.org/mozilla-central/source/browser/base/content/test/urlbar/browser_urlbarOneOffs.js
|-
|  Performance Testing 
|style="text-align:center;" | TBD || 
|-
|  All Defects Logged 
|style="text-align:center;" | {{mprog|}} || 
|-
|  Critical/Blockers Fixed and Verified 
|style="text-align:center;" | {{mprog|}} || 
|-
|  Metrics/Telemetry|| 
|style="text-align:center;" | 
|-
|  QA Signoff  - Nightly Release|| 
|style="text-align:center;" | Email to be sent 
|-
|  QA Aurora - Full Testing 
|style="text-align:center;" |  || 
|-
|  QA Signoff  - Aurora Release || 
|style="text-align:center;"| Email to be sent 
|-
|  QA Beta - Full Testing
|style="text-align:center;" |  || 
|-
|  QA Signoff  - Beta Release || 
|style="text-align:center;" | Email to be sent 
|}