Issue Details (XML | Word | Printable)

Key: JRA-7323
Type: Improvement Improvement
Status: Open Open
Priority: Major Major
Assignee: Unassigned
Reporter: Scott Bilas
Votes: 3
Watchers: 2
Operations

Add/Edit UI Mockup to this issue
If you were logged in you would be able to see more operations.
JIRA

Comments provided when changing, linking or resolving an issue should be displayed next to the record of that action

Created: 14/Jul/05 01:31 AM   Updated: 24/Jun/08 11:32 PM
Component/s: Comments, UI / Usability, Web interface
Affects Version/s: 3.2.2
Fix Version/s: None

Time Tracking:
Not Specified

Issue Links:
Duplicate
 
Reference
 

Participants: Anton Mazkovoi [Atlassian] and Scott Bilas
Since last comment: 3 years, 20 weeks, 3 days ago
Labels:


 Description  « Hide
JIRA allows you to enter comments in several situations that aren't just commenting on an issue:
  • when editing the issue
  • when linking one issue to another
  • in a workflow transition screen, like when resolving an issue.

These three cases are different to a normal comment on the issue that adds more information, but these comments are shown in the normal stream. The UI around comments should be improved so that edit comments are shown near the information about the edit, for example.

Given the current tabbed UI, that would mean edit comments, workflow comments and link comments appear in the Change History tab next to the change, not on the Comments tab.

As an example, consider the situation when you're linking several bugs to one bug. Perhaps they're all related. I just did this myself with about six bugs that are all related to a similar component in the system. I link each bug with the same comment:

"i believe this is a similar issue to LH-1901. not our problem, but needs confirmation from sean and by trying on a previous build."

This works fine for the linked bugs, but if I go to the "master" bug that everything is linked to, I see a long list of comments, each identical, that make no sense whatsoever because there's no context. Sure I can go to the All tab and puzzle out what all the field changes mean and see how all the comments are interleaved...

It would be soooo much more useful if all the context was on the same page. Example. Instead of:

Comment by Scott Bilas [07/13/05 09:48 PM] [ Permlink ]
i believe this is a similar issue to LH-1901. not our problem, but needs confirmation from sean and by trying on a previous build.

Comment by Scott Bilas [07/13/05 09:49 PM] [ Permlink ]
i believe this is a similar issue to LH-1901. not our problem, but needs confirmation from sean and by trying on a previous build.

....

we would have this:

Linked to LH-1774 as Related by Scott Bilas [07/13/05 09:48 PM] [ Permlink ]
i believe this is a similar issue to LH-1901. not our problem, but needs confirmation from sean and by trying on a previous build.

Linked to LH-1971 as Related by Scott Bilas [07/13/05 09:49 PM] [ Permlink ]
i believe this is a similar issue to LH-1901. not our problem, but needs confirmation from sean and by trying on a previous build.



 All   Comments   Work Log   Change History      Sort Order: Ascending order - Click to sort in descending order
Scott Bilas added a comment - 14/Jul/05 01:36 AM
The point of this bug was to talk about how it's really weird to have a comment on a bug that was generated by an activity on the bug, but without any context. Unless the user types in what they did like "I'm linking this as related because of x" the comment on its own makes no sense.

And practically nobody uses the "All" view because it's so incredibly messy and hard to read.

What I'm suggesting is that we have something more human readable that combines all the info related to changes on the bugs in one compact place, so that the comments people add when they modify bugs have plenty of context so we know what they did as well as why. Right now we have to pick one or the other, or choose an overly verbose view.


Anton Mazkovoi [Atlassian] added a comment - 14/Jul/05 05:37 AM
I agree, a lot of confusion comes arises from teh fact that the comment gets added to both issues.

If we add a comment only to one issue (the one the user is linking) would this solve the problem? Most people do not realise the comment is added to teh linked issue as well.


Scott Bilas added a comment - 14/Jul/05 11:07 AM
Adding the comment to only one issue would fix one problem and add another. Although I think it's a good fix for some types of links. I don't know how many times I've linked a bug as a duplicate and how weird it looks on the dup bug to see the comment "dup of XYZ-123" when I'm looking at XYZ-123 right now. Still, that only is a problem on the duplicate link type. We have other link types (such as "is related to") which are symmetrical, and we would want the comments added in both places. Might actually work well to have a checkbox "symmetrical" on a link type that just sets both ends to be the same, and then only in that case would a comment added to a new link get added to both bugs. This would also solve the issue of having "is related to" being listed in the dropdown for linking a bug twice.

But I really think the best option is to tack on human-readable text so we get the full context instead of the simple "Comment by". It would solve a whole slew of other usability issues related to using the bugbase.

Alternatively, make the "Change by" human-readable. The generic Field - Original Value - New Value is really hard to read. For example on this bug, there was a change by Anton today with three fields updated. Takes me a while to read all that with the table format. It would be so much more readable if it looked like this:

Edited by Anton Mazkovoi [14/Jul/05 05:35 AM]
...Fix Version/s set to 3.3 [11121]
...Assigned to Dylan Etkin [dylan@atlassian.com]
...and Priority changed from Major [3] to Critical [2]

For a resolved bug, something like:

Resolved as By Design by Anton Mazkovoi [14/Jul/05 05:35 AM]
...and Assigned to Dylan Etkin [dylan@atlassian.com]

Something like that. So the first line would be what happened, and lines after that would simply say in English what changed (similar to how the workflow editor prints field change tasks in English). It would be so much easier to read, and then I'd just leave my browser in "All" mode all the time.

This is what MS's Product Studio does, and it's really nice and compact.


Anton Mazkovoi [Atlassian] added a comment - 14/Jul/05 05:48 PM
Fair enough, I see what you mean.

Unfortuantely the 3.3 release is very close and we will not have time to implement this feature (adding comments to only 1 issue would be much simpler).

Thanks for the suggestion.

Anton