A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on IRC (such as one of these permanent autoconfirmed members).

Difference between revisions of "Bugzilla conventions"

From WHATWG Wiki
Jump to: navigation, search
m (Priorities: Typo)
Line 39: Line 39:
 
* [http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=HTML+WG&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&resolution=LATER&resolution=REMIND&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= List of LATERed bugs]. Some of these are commonly duped. In particular [http://www.w3.org/Bugs/Public/show_bug.cgi?id=7798 bug 7798] is TextMetrics.height which is often requested.
 
* [http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=HTML+WG&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&resolution=LATER&resolution=REMIND&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= List of LATERed bugs]. Some of these are commonly duped. In particular [http://www.w3.org/Bugs/Public/show_bug.cgi?id=7798 bug 7798] is TextMetrics.height which is often requested.
 
* [http://www.w3.org/Bugs/Public/buglist.cgi?bug_file_loc=&bug_file_loc_type=allwordssubstr&bug_id=&bug_id_type=anyexact&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&chfieldfrom=&chfieldto=Now&chfieldvalue=&component=HTML%20Canvas%202D%20Context%20%28editor%3A%20Ian%20Hickson%29&component=HTML%20Microdata%20%28editor%3A%20Ian%20Hickson%29&component=HTML5%20spec%20%28editor%3A%20Ian%20Hickson%29&component=other%20Hixie%20drafts%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML%20Canvas%202D%20Context%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML%20Microdata%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML5%20spec%20%28editor%3A%20Ian%20Hickson%29&email1=&email2=&emailtype1=substring&emailtype2=substring&field0-0-0=noop&keywords=&keywords_type=allwords&longdesc=&longdesc_type=allwordssubstr&product=HTML%20WG&query_format=advanced&short_desc=&short_desc_type=allwordssubstr&status_whiteboard=&status_whiteboard_type=allwordssubstr&type0-0-0=noop&value0-0-0=&votes=&query_based_on=&columnlist=bug_severity%2Cpriority%2Creporter%2Cbug_status%2Cresolution%2Cop_sys%2Cshort_desc%2Cchangeddate List of all open bugs in specs edited by Hixie, sorted by ascending last change time]
 
* [http://www.w3.org/Bugs/Public/buglist.cgi?bug_file_loc=&bug_file_loc_type=allwordssubstr&bug_id=&bug_id_type=anyexact&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&chfieldfrom=&chfieldto=Now&chfieldvalue=&component=HTML%20Canvas%202D%20Context%20%28editor%3A%20Ian%20Hickson%29&component=HTML%20Microdata%20%28editor%3A%20Ian%20Hickson%29&component=HTML5%20spec%20%28editor%3A%20Ian%20Hickson%29&component=other%20Hixie%20drafts%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML%20Canvas%202D%20Context%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML%20Microdata%20%28editor%3A%20Ian%20Hickson%29&component=pre-LC1%20HTML5%20spec%20%28editor%3A%20Ian%20Hickson%29&email1=&email2=&emailtype1=substring&emailtype2=substring&field0-0-0=noop&keywords=&keywords_type=allwords&longdesc=&longdesc_type=allwordssubstr&product=HTML%20WG&query_format=advanced&short_desc=&short_desc_type=allwordssubstr&status_whiteboard=&status_whiteboard_type=allwordssubstr&type0-0-0=noop&value0-0-0=&votes=&query_based_on=&columnlist=bug_severity%2Cpriority%2Creporter%2Cbug_status%2Cresolution%2Cop_sys%2Cshort_desc%2Cchangeddate List of all open bugs in specs edited by Hixie, sorted by ascending last change time]
 +
 +
== Bookmarklets ==
 +
 +
If you're editing the spec you may find these useful:
 +
 +
[javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Rejected%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'WONTFIX'%3B%20document.getElementById('resolution_settings').className%20%3D%20''%3B%20undefined Reject]
 +
[javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Accepted%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20This%20seems%20to%20have%20been%20fixed%20already.%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'WORKSFORME'%3B%20document.getElementById('resolution_settings').className%20%3D%20''%3B%20undefined Already done]
 +
[javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Did%20Not%20Understand%20Request%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20I%20don't%20understand.%20Could%20you%20elaborate%3F%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'NEEDSINFO'%3B%20document.getElementById('resolution_settings').className%20%3D%20''%3B%20undefined Ask fore more info]

Revision as of 21:48, 24 June 2011

These are the conventions used for bugs filed in the W3C Bugzilla for specs also maintained by the WHATWG.

Subject prefixes

Some specific topics have prefixes in the bug summaries to help group the bugs.

<video>
bugs relating to <video>, <audio>, HTMLMediaElement, Controller, WebVTT, WebRTC (PeerConnection and Stream), and closely related topics.
WF2:
bugs relating to form controls.
WF3:
feature requests relating to form controls.
PUB:
something relating to the spec publication process (including anolis, spec splitter, the START and END markers, etc)

Priorities

See bug priority policy according to the chairs. Initial commenters are only allowed to set priority to P3 or lower. Editors and editorial assistants can change it freely. Chairs can decide on a final priority. P1 is very urgent. P2 or P3 is for technical comments except possibly feature requests. P4 or P5 is editorial or non-technical, or feature requests.

Severities

All bugs should be normal severity by default. Typos, grammar mistakes that don't affect normative status, and other such trivial matters can be marked "trivial". Feature requests should be marked "enhancement". Bugs that affect the parser algorithm should be marked "critical". Bugs that are immediately affecting implementors should be marked "blocker". "major" and "minor" are currently unused. The severity field is "owned" by the editor.

Components

The bug filing system should automatically pick the right component. The components are pretty self-explanatory. WHATWG-specific issues should be moved to the "other Hixie drafts" component.

Resolutions

The boilerplate used when resolving the bug comes from: http://lists.w3.org/Archives/Public/public-html/2009Oct/0680.html

The requirements for use of different resolutions are here:

http://dev.w3.org/html5/decision-policy/decision-policy-v2.html#bug-resolutions

Helpful query links

Bookmarklets

If you're editing the spec you may find these useful:

[javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Rejected%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'WONTFIX'%3B%20document.getElementById('resolution_settings').className%20%3D%20%3B%20undefined Reject] [javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Accepted%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20This%20seems%20to%20have%20been%20fixed%20already.%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'WORKSFORME'%3B%20document.getElementById('resolution_settings').className%20%3D%20%3B%20undefined Already done] [javascript:document.getElementsByTagName('textarea')%5B0%5D.value%20%2B%3D%20%22EDITOR'S%20RESPONSE%3A%20This%20is%20an%20Editor's%20Response%20to%20your%20comment.%20If%20you%20are%20satisfied%20with%20this%20response%2C%20please%20change%20the%20state%20of%20this%20bug%20to%20CLOSED.%20If%20you%20have%20additional%20information%20and%20would%20like%20the%20editor%20to%20reconsider%2C%20please%20reopen%20this%20bug.%20If%20you%20would%20like%20to%20escalate%20the%20issue%20to%20the%20full%20HTML%20Working%20Group%2C%20please%20add%20the%20TrackerRequest%20keyword%20to%20this%20bug%2C%20and%20suggest%20title%20and%20text%20for%20the%20tracker%20issue%3B%20or%20you%20may%20create%20a%20tracker%20issue%20yourself%2C%20if%20you%20are%20able%20to%20do%20so.%20For%20more%20details%2C%20see%20this%20document%3A%5Cn%20%20%20http%3A%2F%2Fdev.w3.org%2Fhtml5%2Fdecision-policy%2Fdecision-policy.html%5Cn%5CnStatus%3A%20Did%20Not%20Understand%20Request%5CnChange%20Description%3A%20no%20spec%20change%5CnRationale%3A%20I%20don't%20understand.%20Could%20you%20elaborate%3F%22%3B%20document.changeform.bug_status.value%20%3D%20'RESOLVED'%3B%20document.changeform.resolution.value%20%3D%20'NEEDSINFO'%3B%20document.getElementById('resolution_settings').className%20%3D%20%3B%20undefined Ask fore more info]