Edgewall Software
Modify

Opened 19 years ago

Last modified 3 years ago

#1233 new enhancement

Descriptions of Components

Reported by: Matthew Harrison Owned by:
Priority: normal Milestone: next-dev-1.7.x
Component: ticket system Version: 0.8
Severity: major Keywords: component version
Cc: leho@…, dale.miller@…, tony@…, notify_craig@…, whatrevolution@… Branch:
Release Notes:
API Changes:
Internal Changes:

Description

One annoying problem we have with our existing bug-tracking system is that users often don't know what component to select for a ticket. They often end up choosing an inappropriate one.

One could argue that better component names would minimise this, but I've often found users to be endlessly creative in their quest to misunderstand the (seemingly) obvious ;-) A nice feature of bugzilla is that the component selector label is a link to a page listing the components for the project, along with owner and description. (If you prefer the link could be a separate item, like a '?' icon.)

(Currently I'm conducting a trial of trac, and I quite like it!)

Attachments (0)

Change History (43)

comment:1 by Christian Boos, 19 years ago

Owner: changed from Jonas Borgström to Christian Boos
Status: newassigned

A component could be a specific Trac object. Clicking on a component would go to its page, which would contain a wiki description.

See other suggested use for a Component object in TracMultipleProjects/SingleEnvironment#UsingComponentobjects.

comment:2 by Christopher Lenz, 19 years ago

Components now have a "description" column in the table. It's not being used yet, but it will be in the future for this purpose.

comment:3 by Christian Boos, 18 years ago

Status: assignednew

(changing the status, as I've not actually started to work on that yet)

comment:4 by Christian Boos, 18 years ago

Keywords: object added

comment:5 by Christian Boos, 18 years ago

Keywords: tracobject added; object removed

comment:6 by Christian Boos, 17 years ago

Milestone: 1.0

Can be done in GenericTrac, as a second step, in order to validate the steps needed to create of a new kind of resource.

comment:7 by Christian Boos, 16 years ago

Milestone: 1.00.12

#5860 closed as duplicate (was asking to actually make use of the component description that one can already set in the component admin panel).

in reply to:  2 comment:8 by Christian Boos, 16 years ago

Keywords: component added; tracobject removed

Replying to cmlenz:

Components now have a "description" column in the table. It's not being used yet, but it will be in the future for this purpose.

Re-focusing this ticket for this goal. For the idea of having components as first-class object in the Trac system, see #3911. #7411 closed as duplicate of this ticket.

comment:9 by Remy Blank, 15 years ago

Milestone: 0.130.12
Owner: changed from Christian Boos to Remy Blank

This feature sounds useful. How about the following plan:

  • Add a [[TicketComponents]] macro that expands to the list of components, with their descriptions and owners (similar to [[TracIni]] as a table, for example).
  • Create a default page TicketComponents that includes the macro and some explanations.
  • Link to the TicketComponents page from the "Component" label in the ticket properties, as suggested by the reporter.

comment:10 by Remy Blank, 15 years ago

The same functionality was requested on trac-users, but for the version field. In principle, nothing would stop us from adding a description to all enumerated field types, and to have a TicketEnumFields page with one table for each field containing the values and descriptions.

I'll start with the fields that have a description.

in reply to:  10 ; comment:11 by jhammel@…, 15 years ago

Replying to rblank:

The same functionality was requested on trac-users, but for the version field. In principle, nothing would stop us from adding a description to all enumerated field types, and to have a TicketEnumFields page with one table for each field containing the values and descriptions.

I'll start with the fields that have a description.

In general, it would be nice to have wiki macros for the descriptions of fields with descriptions. They could then be used in the ticket form and where ever else the information is desired.

in reply to:  11 comment:12 by Remy Blank, 15 years ago

Replying to jhammel@…:

In general, it would be nice to have wiki macros for the descriptions of fields with descriptions. They could then be used in the ticket form and where ever else the information is desired.

Do you mean a macro that takes a field name and value, and expands to the description of the field value? How would you use that in the ticket form?

comment:13 by Remy Blank, 15 years ago

Milestone: 0.120.12.1

Doesn't block 0.12, re-targeting.

comment:14 by Emil Bleaker <emil_bleaker@…>, 14 years ago

Type: defectenhancement

This sounds more like an enhancement than a defect.

in reply to:  10 ; comment:15 by Ryan Ollos <ryano@…>, 14 years ago

Replying to Matthew Harrison:

A nice feature of bugzilla is that the component selector label is a link to a page listing the components for the project, along with owner and description. (If you prefer the link could be a separate item, like a '?' icon.)

Replying to rblank:

This feature sounds useful. How about the following plan:

  • Add a [[TicketComponents]] macro that expands to the list of components, with their descriptions and owners (similar to [[TracIni]] as a table, for example).
  • Create a default page TicketComponents that includes the macro and some explanations.
  • Link to the TicketComponents page from the "Component" label in the ticket properties, as suggested by the reporter.

This could mostly be hacked together with the current system, which is sort of what I have done.

I've used the th:WikiTableMacro to show a list of components on a page, along with their descriptions.

{{{
#!SQLTable
SELECT name, description FROM component ORDER BY name
}}}

However, I agree that the macro would be a nice feature.

I've changed the ticket template to transform the Component: text into a link to a wiki page.

Another nice feature would be to have a tooltip showing the description when there is a mouseover on a particular component in the drop down list.

Replying to rblank:

The same functionality was requested on trac-users, but for the version field. In principle, nothing would stop us from adding a description to all enumerated field types, and to have a TicketEnumFields page with one table for each field containing the values and descriptions.

If this could be extended to custom fields as well, that would be ideal. I have a wiki page that explains all of the fields of the tickets, including a number of custom fields. I use the SQL query as shown above for items such as Component, but I have had to manually create and update the wiki page for custom fields.

comment:16 by Christian Boos, 14 years ago

Milestone: next-minor-0.12.xnext-major-0.1X

Too big enhancement for a minor version.

comment:17 by Christian Boos, 14 years ago

Owner: Remy Blank removed
Severity: normalmajor

comment:18 by Remy Blank, 14 years ago

Owner: set to Remy Blank

Hey! I'm still interested!

comment:19 by Christian Boos, 14 years ago

Well, yes, but me too ;-)

I reset the owner as we're having two different approaches here (comment: 6 vs comment:9), and no immediate progress in either direction.

comment:20 by lkraav <leho@…>, 14 years ago

btw, th:ComponentsProcessorMacro exists. looking at the this ticket's description, i think it could serve as a hold-me-over in many cases.

comment:21 by lkraav <leho@…>, 14 years ago

Cc: leho@… added

comment:22 by dale.miller@…, 13 years ago

Cc: dale.miller@… added

comment:23 by tony@…, 11 years ago

Cc: tony@… added

in reply to:  15 comment:24 by Ryan J Ollos <ryan.j.ollos@…>, 11 years ago

Cc: ryan.j.ollos@… added

Replying to Ryan Ollos <ryano@…>:

Another nice feature would be to have a tooltip showing the description when there is a mouseover on a particular component in the drop down list.

This has been implemented by matobaa in the FieldTooltipPlugin.

I'd be interested in implementing the plan in comment:9 for Components, Versions and all of the ticket enums. I've also previously thought it would be valuable to have a Description field for the ticket enums, so I'd also be interested in implementing that feature as well (comment:10).

Would there be interesting in integrating those features into the core if I developed them on a branch, or is the focus entirely on the long-term vision of GenericTrac?

comment:25 by Christian Boos, 11 years ago

It would be nice as such. For this kind of feature, changing the DB representation would have little impact, so no need to delay.

The current link on the component field of tickets goes to a custom query for that component, it would be nice to somehow keep that possibility with the proposed macro, even indirectly (i.e. the macro could generate that link into an extra column open tickets).

OTOH, having a full blown component "page", looking much like the milestone page, but with side-by-side edit capabilities like a wiki page, keeping track of the history of changes, etc. is of course what GenericTrac is about ;-)

comment:26 by Ryan J Ollos <ryan.j.ollos@…>, 11 years ago

Okay, cool. I have a few other in-progress patches to finish up first, but I'll add this ticket to the queue, and hope to provide a patch in the coming weeks.

comment:27 by notify_craig@…, 11 years ago

Cc: notify_craig@… added

comment:28 by Ryan J Ollos, 11 years ago

Cc: ryan.j.ollos@… removed
Milestone: next-major-releasesnext-dev-1.1.x
Owner: changed from Remy Blank to Ryan J Ollos
Status: newassigned

comment:29 by whatrevolution@…, 10 years ago

Cc: whatrevolution@… added

comment:30 by Ryan J Ollos, 10 years ago

Milestone: next-dev-1.1.x1.1.3

in reply to:  10 comment:31 by Ryan J Ollos, 10 years ago

Replying to rblank:

The same functionality was requested on trac-users, but for the version field. In principle, nothing would stop us from adding a description to all enumerated field types,

#11649 is a ticket for adding a description field to each ticket system enum.

in reply to:  9 comment:32 by Ryan J Ollos, 10 years ago

Replying to rblank:

  • Add a [[TicketComponents]] macro that expands to the list of components, with their descriptions and owners (similar to [[TracIni]] as a table, for example).

Since this ticket will be a large amount of work I created a separate ticket for adding the macro: #11702.

comment:33 by Ryan J Ollos, 9 years ago

Milestone: 1.1.3next-dev-1.1.x

It's probably more realistic to target this in milestone:1.1.4 or later.

comment:34 by Ryan J Ollos, 9 years ago

Milestone: next-dev-1.1.x1.1.5

comment:35 by Ryan J Ollos, 9 years ago

#5211 is a subtask in implementing first-class Component objects.

Version 0, edited 9 years ago by Ryan J Ollos (next)

comment:36 by Ryan J Ollos, 9 years ago

Milestone: 1.1.51.2

comment:37 by Ryan J Ollos, 9 years ago

Milestone: 1.21.1.6

Milestone renamed

comment:38 by Ryan J Ollos, 9 years ago

Milestone: 1.1.6next-dev-1.1.x
Owner: Ryan J Ollos removed
Status: assignednew

comment:39 by Ryan J Ollos, 9 years ago

#4827 requests that addition of COMPONENT_CREATE, COMPONENT_MODIFY, etc …

comment:40 by Ryan J Ollos, 9 years ago

Milestone: next-dev-1.1.xnext-dev-1.3.x

Narrowing focus for milestone:1.2. Please move ticket to milestone:1.2 if you intend to fix it.

comment:41 by Ryan J Ollos, 7 years ago

Keywords: version added

comment:42 by Ryan J Ollos, 5 years ago

Milestone: next-dev-1.3.xnext-dev-1.5.x

Milestone renamed

comment:43 by Ryan J Ollos, 3 years ago

Milestone: next-dev-1.5.xnext-dev-1.7.x

Milestone renamed

Modify Ticket

Change Properties
Set your email in Preferences
Action
as new The ticket will remain with no owner.
The ticket will be disowned.
as The resolution will be set. Next status will be 'closed'.
The owner will be changed from (none) to anonymous. Next status will be 'assigned'.

Add Comment


E-mail address and name can be saved in the Preferences .
 
Note: See TracTickets for help on using tickets.