web-bugs

A repo used by the Web Compatibility community to track issues reported via webcompat.com

###Labels Labels are used for helping to filter bugs into groups but also to track the status of the bug. Here’s what each label means:

• android - The bug exists in an Android browser
• chrome - The bug exists in Google Chrome
• contactready - Issue has been analyzed and is ready for someone to contact the site
• firefox - The bug exists in Mozilla Firefox
• ie - The bug exists in Microsoft Internet Explorer
• ios - The bug exists in an iOS browser
• mobile - The bug exists on mobile devices
• needsinfo - Someone has requested more information from another person
• opera - The bug exists in Opera browser
• safari - The bug exists in Apple Safari
• sitewait - Someone has attempted to contact the website
• duplicate - The issue has been reported previously and is being tracked in another bug
• invalid - The issue has been diagnosed as not being a compatibility bug
• wontfix - The site has been contacted and refuses to fix the bug

###Best practices

If you’re using Webcompat.com already, you’re probably pretty awesome. So why do you need to read this? Well from experience we know a few tricks that make the web compatibility process go even smoother. And who doesn’t want to learn sweet new tricks?

####Filing web compatibility bugs

• Fill the bug report form out completely. The more information you provide the easier it is for volunteers to understand the problem
• List any other browsers you tested the site with
• Try to avoid reporting issues for sites that are broken in all browsers. We like to focus our energy on sites that work in one browser but not others
• If you feel comfortable dig in and analyze the bug as well

####Analyzing web compatibility bugs

• Confirm that you can reproduce the error. Ideally you should use a clean browser profile. See this tutorial for Firefox.
• Set any related flags - if the bug appears on Chrome for Android, set the “Chrome” and “Android” flags
• Provide details on which piece of code is broken
• List out any relevant error codes
• If possible, suggest a way to fix the code to work in all browsers
• Once complete, add the “contactready” label
• If you feel comfortable find a contact at the site and reach out

####Contacting the site/company

• Once a bug is set to “contactready” the site can be contacted
• After you have attempted to make contact remove the "contactready" label and add "sitewait" so others don't attempt to contact
• Leave details about who you are contacting, example “Joe Webmaster - Developer at Company X”
• Be careful not to leak any private information like email addresses, phone numbers
• If you post somewhere public like twitter, include the link to the tweet in the bug for easy tracking
• If you receive an issue tracking number from the site include this in the bug
• When you receive responses, leave some information on the bug (paraphrasing is fine)
• If no response is received after a week or two, try another method. After a month or three contact attempts we can stop and revisit it later