View source for Compatibility/Diagnosis

= Needs Diagnosis Queues by Team =
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*webcompat&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Web Compat]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*domt&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp DOM]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*dom-storage&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp DOM Storage]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*graphics&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Graphics]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*javascript&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Javascript]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*layout&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Layout]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*media&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Media]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*networking&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Networking]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*privacy&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Privacy]
* [https://bugzilla.mozilla.org/buglist.cgi?v1=webcompat%3Aneeds-diagnosis&v2=diagnosis-team%3A\s*video-conferencing&order=Importance&query_format=advanced&resolution=---&f1=keywords&f2=cf_user_story&o1=substring&o2=regexp Video Conferencing]
* [https://bugzilla.mozilla.org/buglist.cgi?f10=CP&f4=OP&f8=component&v1=impact%3A.%2A&o7=equals&order=Importance&f9=CP&o3=substring&v2=diagnosis-team%3A.%2A&o1=regexp&v7=Web%20Compatibility&f5=keywords&v3=webcompat%3Aneeds-diagnosis&list_id=17149682&o2=notregexp&o8=equals&v5=webcompat%3Asite-report&f7=product&query_format=advanced&j4=OR&f3=keywords&f1=cf_user_story&v8=Site%20Reports&o5=substring&resolution=---&f2=cf_user_story&classification=Client%20Software&classification=Developer%20Infrastructure&classification=Components&classification=Server%20Software&classification=Other&f6=OP&priority=P1&priority=P2 Unset P1/P2]

= Diagnosis Process =

== Document your diagnosis ==
During diagnosis document whatever progress you made. This will help anyone else looking at the bug to pick up where you left off.

If you get stuck and need help from the webcompat team, set <code>diagnosis-team: webcompat</code> in the User Story field. If you think the issue is in another component you may set that component directly in the user story (using the [https://addons.mozilla.org/en-GB/firefox/addon/site-issue-triage/ site issue triage addon] is recommended to get the data format correct).

== Diagnosis Done? ==

Once you understand the root cause of the issue:
* Remove the <code>webcompat:needs-diagnosis</code> keyword to indicate that diagnosis is complete
* If the root cause is a platform bug, set the <code>webcompat:platform-bug</code> keyword, and set the site report bug to depend on the platform bug(s) that cause the issue. These bugs should also have the <code>webcompat:platform-bug</code> keywords set.
* If the root cause is a problem with the site (e.g. sending incorrect code to Firefox) then set either <code>webcompat:needs-contact</code> or <code>webcompat:contact-ready</code> keywords depending on whether we have an existing relationship with the site.
* If the problem might have a workaround (e.g. spoofing as another browser, or changing some CSS) set <code>webcompat:needs-sitepatch</code>.
* If the problem is an area where the spec is ambiguous, and the site depends on a specific behavior, or where Gecko is following the spec but other browsers are not, or some similar case where a Gecko bug might be marked as <code>WONTFIX</code>, file an issue in <code>Web Compatibility :: Knowledge Base</code> describing the problem, and linking to any spec issues, or issues on other browsers, and set the site report bug to depend on this knowledge base bug.

[[Category:Web Compatibility|Guide]]