coming attraction: comment tagging

16th Oct 2012

i’ve been working on a bugzilla enhancement which allows you to tag individual comments with arbitrary strings.

tagging

tagged

it’s tracked in bug 793963, currently waiting for review, and will be back-ported to bugzilla.mozilla.org.

comment tagging features:

automatic collapsing of comments

the bugzilla administrator can configure a list of comment tags which will result in those comments being collapsed by default when a bug is loaded.

this allows obsolete or irrelevant comments to be hidden from the information stream.

comment grouping/threading

bugzilla will show a list of all comment tags in use on the bug, and clicking on a tag will expand those comments while collapsing all others.

tags

this allows for simple threading of comments without diverging significantly from the current bugzilla user interface, api, and schema. you’ll be able to tag all comments relating to the same topic, and remove comments no longer relevant to that thread by removing the tag.

highlighting importing comments

on bugs with a lot of information, it can be time consuming for people not directly involved in the bug to find the relevant comments. applying comment tags to the right comments assists this, and may negate the need for information to be gathered outside of bugzilla.

for example:

  • tagging a comment with “STR” (steps to reproduce) will help the qa team quickly find the information they need to verify the fix
  • writing a comment summarising a new feature and tagging it with “docs” will help the generation of documentation for mdn or similar

implementation notes

  • the “add tag” input field has an auto-complete drop-down, drawing from existing tags weighted by usage count
  • by default editbugs membership is required to add tags to comments
  • comment tags are not displayed unless you are logged in to bugzilla
  • tags are added and removed via xhr, changes are immediately visible to the changer without refreshing the page
  • tagging comments will not trigger bugmail, nor alter a bug’s last-modified date
  • tags added by other users (or on other tabs) will generally not be visible without a page refresh