Mobile/Testdrivers Program/How To/File a Bug

From MozillaWiki
Jump to: navigation, search

These instructions are meant to help you file a bug that's actionable for engineering.

Create a Bugzilla Account

  • If you don't have a Bugzilla account, go to the sign-up page and check out the image steps if necessary (keep clicking Next-->).
  • Use the same email you signed up for the Test Drivers Program with, if possible.

Did Firefox Crash?

Try to get the crash ID, see these image steps (keep clicking Next-->) ==

  • The last step in the instructions is to grab the "Crash Report ID", put this in a safe place and add it to the bug you file below

If possible, get a Log

If this is your first time visiting this page, you probably don't have the log capturing app installed already, please install it as per the instructions below and then try to reproduce your issue.

  • Install the free app 'aLogCat' on your device
  • Open aLogCat, pause the logs, go to the app's menu and "Clear" the log, then restart the log gathering
  • Close aLogCat and go to Aurora, do your tests or reproduce the steps that caused the issues you're seeing.
  • Once you've reproduced the issue(s), close Aurora and return to aLogCat where the in-app menu gives you the option to "Share" the logs gathered. Share to yourself via email or other method that gives you a way to grab the log and create a text file that you will be able to attach to a bug

If possible, take screenshots

If you are able to take screenshots of the issues, or take photos of the screen with another device, those images can also be useful to the developers and can be attached to a bug along with log files.

On Android 4.0 (Ice Cream Sandwich): hold volume down and power buttons at the same time

File the BUG report here

Following the link above to the bug report will give you a form to fill out. Here are tips on filing the actual bug report:

Hopefully you have the log file (text file containing logs grabbed in the log capture instructions, and you can attach it and any screenshots to the bug.

Please take the time to write:

  • An accurate summary of your issue. “Aurora crashes when trying to load an image on http://facebook.com” is way more useful than “Facebook doesn't work”
  • A description that explains what you see, what you expected to see, and any other pertinent information
  • Steps to reproduce. If you can take a reproducible sequence of actions to cause a bug to manifest, we will be really grateful, and the bug is much more likely to be fixed than one we have to guess at
  • A description of your device and the version of Fennec you're using. Something like “Samsung Galaxy S2, Android 2.3.4, Nightly build from 2012-05-04” is enough. You can find out your Android version in the Settings application.

You can ignore everything but the "Summary" (bug title) and "Description".

"Steps to reproduce" are a rough outline of how you found the problem. The more info, the better. If you don't know how you got into a situation, try to reproduce the issue. If you can't, please still file a bug!

Watch for "bug mail", and reply if necessary

You'll sometimes get emails with a subject similar to "[Bug xxxxx] When moving the page around, the page continues to glide":

  • Please read these emails and look for any questions directed at you
  • If a reply is necessary, click the link at the top of the email and then input a reply in the text box at the bottom of the page.