Compatibility/Guide/Triage

From MozillaWiki
< Compatibility‎ | Guide
Revision as of 14:32, 17 January 2017 by Astevenson (talk | contribs) (→‎Close Status: add incomplete)
Jump to navigation Jump to search

Triage Process

Once a new bug report has been created, it must go through Triage to determine if it should get further investigation or be closed.

Profile

When performing Web Compatibility testing it is best to keep a separate profile in your browsers. This ensures your personal settings do not interfere with the test results.

Attempt to Reproduce Issue

Read the description provided by the reporter. Using the browser the reporter found the issue in, navigate to the URL provided and follow the steps to reproduce the issue. If steps to reproduce are not available, try to identify what the reporter may have been referring to.

It isn't critical at this point to use the exact same version of browser as reported. Ideally you should be using a release version of the browser or higher.

After testing the results in the reported browser, test the same site in another browser. For example if the reported browser was Firefox, try testing in Edge, Chrome or another popular browser.

For it to be a valid Web Compatibility the issue would exist in one browser but not in another. There are some common reasons why a bug would be invalid.

Able to Reproduce

Screenshot

If the reporter hasn't provided a screenshot of the issue and it's visible, take a screenshot to upload to the bug report. It helps to provide a screenshot in the working browser as well.

Document

In the bug report, explain how you reproduced the issue. Make note of:

  • Any additional information is required like accounts, zip/postal code etc.
  • Regional differences on the site - example: google.com vs. google.co.uk
  • Contextual information that may be useful
  • Error console logs if they seem relevant and you are comfortable

Bug Status

After you've made your comment on the bug report, you should set the status to needsdiagnosis.

If additional information is required, you can set the needsinfo status.

Unable to Reproduce

Keep Testing

If you weren't able to reproduce the issue initially try:

  • Try exact browser version listed
    • Start with the exact browser version first, only occasionally will you find issues that are Operating System specific
  • Test with tracking protection enabled
  • Test with an ad-blocker

Explain the Results

If you are still unable to reproduce, comment on the bug report with your findings. Sometimes a screenshot can help the original reporter understand why you aren't able to reproduce the issue.

Close Bug

Close the bug report if you are confident it is either not a compatibility bug, or that this issue can't be reproduced. If you aren't sure, ping someone from the Webcompat team to take a look.

Close Status

Set the status of the bug:

  • Invalid
    • It isn't a valid Web Compatibility issue
  • Worksforme
    • The issue cannot be reproduced
  • Duplicate
    • The issue has been reported previously, it helps to provide the other bug report number
  • Incomplete
    • Not enough information has been provided by the reporter. Sometimes there is no way to contact the reporter, or they haven't responded with the detail required to reproduce.