[GHC] #12140: Clarify Trac menus for new reporters
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: bug | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Keywords: | Operating System: Unknown/Multiple Architecture: | Type of failure: None/Unknown Unknown/Multiple | Test Case: | Blocked By: Blocking: | Related Tickets: Differential Rev(s): | Wiki Page: -------------------------------------+------------------------------------- An officemate of mine rarely posts bugs here. He finds the interface to posting a bug confusing. I have to say I agree, if I consider the perspective of an infrequent reporter. (The reason he rarely posts bugs is that he rarely has bugs to post, not because of the confusing interface.) Specifically, there are many fields to fill out when posting a bug. Some of these are important to us (`Version` probably being the most). Some are better for developers to set (`Milestone`, `Test case`). Some are less important (`Operating System` for a bug in the type-checker). Some are essentially ignored (`Type of failure`, in my experience). Yet a new reporter doesn't know any of this and will diligently try to fill out them all. Can we label the fields as to importance somehow? Mark some as advanced/dev only? Make some available only after posting the ticket (`Test case`, `Differential`)? I don't suppose there are masses of people out there trying to post bugs and stymied by this problem, but I do think we can clean this up a bit. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * type: bug => task Comment: Hmm, somehow I missed this earlier. I agree that ticket form is a bit daunting. Unfortunately Trac doesn't really provide us with many good options for fixing this short of removing fields. I, for one, have used most of the fields at one point or another and would be reluctant to remove any of them. That being being said, recently mpickering has been evaluating the feasibility of moving GHC's ticket tracking to Phabricator, which, at least on this front, would be a significant improvement over Trac. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): I mentioned this to Herbert and he said that while it isn't necessarily possible to remove fields from the default "new ticket" page, it should be possible to add some in the page template to inform submitters that they are under no obligation to fill in all of the fields. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by goldfire): That might be helpful.... even a little more direction would be an improvement. Thanks for looking! -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): I've added a bit of text at the top of the new ticket page,
Thanks for your ticket! Don't worry if you can't fill in all of the fields, just tell us what you know.
-- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by goldfire): Thanks for adding that. It's helpful, though I imagine 90% of visitors will skip over it. Is it possible to use styling (italics, etc.) in field names? If a visitor sees that some fields are italicized or grayed or xxx, they might look around to find the key. Actually, it would be pretty awesome if we could apply a slight graying to the fields that we don't expect visitors to fill out. I imagine that all tickets all the time would have this graying, but a color change would, I think, be less jarring to us regulars than, say, italics would be. And the graying has just the right connotation to visitors. (We would also add a sentence at the top explaining, for those who look.) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:5 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari):
Actually, it would be pretty awesome if we could apply a slight graying to the fields that we don't expect visitors to fill out. I imagine that all tickets all the time would have this graying, but a color change would, I think, be less jarring to us regulars than, say, italics would be. And the graying has just the right connotation to visitors. (We would also add a sentence at the top explaining, for those who look.)
I think this should be pretty easily done. The next question is what fields in particular do we want users to provide? I suggest the following, * Priority * Version * Operating system * Architecture * Type of failure -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by goldfire): Agreed on those fields. But while we're here, can we tweak Type of failure? I would want to add "Poor/confusing error message" and change "Compile-time crash" to "Compile-time crash or panic". The former is a very common source of bug reports, and I wouldn't want someone reporting a panic to panic for not seeing "panic" in the list. Thanks! -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:7 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
I would want to add "Poor/confusing error message" and change "Compile- time crash" to "Compile-time crash or panic". The former is a very common
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): source of bug reports, and I wouldn't want someone reporting a panic to panic for not seeing "panic" in the list. Done. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:8 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: new Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): Arg. I just looked more carefully at styling the fields of the new ticket form and unfortunately it doesn't look like this will be possible afterall. The problem is that the form itself is generated and the generator provides no `id` or `class` attributes on which to hang a CSS style. Short of maintaining a fork of Trac I'm not sure I see a great way around this. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:9 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12140: Clarify Trac menus for new reporters -------------------------------------+------------------------------------- Reporter: goldfire | Owner: hvr Type: task | Status: closed Priority: normal | Milestone: Component: Trac & Git | Version: 8.0.1 Resolution: wontfix | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by goldfire): * status: new => closed * resolution: => wontfix Comment: Bah. Oh well. We tried. :) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12140#comment:10 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC