Template:Issue

From WikiEducator
Jump to: navigation, search
Title: {{{title}}}  
Submitted by: {{{submitter}}}  
Status: {{{status}}}
Comments: {{{comments}}}
({{{priority}}} priority, {{{effort}}}, {{{progress}}})

Template:Issue

This is an "issue template" useful for issue trackers and progress monitors on tasks etc. colour coded for priority, effort required and progress/status.

Usage

Syntax:

{{Issue
|collapsed=<Yes | No> <default is No>
|title=<your title>
|submitter=~~~~
|status=Description of status/progress.
|priority=<colour name> <or label (see Template:PriorityColour)>
|effort=<colour name> <or label (see Template:EffortColour)>
|progress=<colour name> <or label (see Template:StatusColour)>
|comments=
your comments go here
}}

Colour Coding

Title:
Title of Task Goes Here.
Progress
Priority none trivial easy routine tricky difficult unknown done
high
Background colour above behind the title indicates effort required
not started
medium Background colour behind “Title:” (top left) indicates priority on hold
low
Background colour of the right column indicates progress
ahead
on track
behind
in trouble

Examples

Title: <-Colour on left: priority. Colour in here: effort. Colour on right: progress. Title goes here  
Submitted by: Kim Tucker 23:28, 30 September 2009 (UTC)  
Status: This routine task of medium priority is done.
Comments: Your comments on the issue go here.

The colours are set when using the template as explained in the usage section.

(medium priority, routine, done)
Title: <-Colour on left: priority. Colour in here: effort. Colour on right: progress. Title goes here  
Submitted by: Kim Tucker 23:28, 30 September 2009 (UTC)  
Status: This tricky medium priority task is in trouble
Comments: Your comments on the issue go here.

The colours are set when using the template as explained in the usage section.

(medium priority, tricky, in trouble)

Comments

Suggestions

  • Rightmost column's width in collapsible table seems fixed. Is there a way round this? (wanted 15px).

Done

Enhanced to

  • Make the default not collapsed and added a parameter to set this.
  • Use collapsible tables.
  • Have the colour of the top left cell indicate the priority of the task, the title cell background colour to indicate the amount of effort the task might require, and add a thin right column whose colour indicates status/progress.
  • Allow users of the template indicate by labels rather than colours via "look-up templates" (i.e. indicate priority as "high" rather than "red", etc. In this way, the colour schemes may be edited in one place without having to edit all the instances of its use.
  • Include a last row summarising the colour indications for those who cannot see them.

Related Templates

The template is used in conjunction with the following templates which lookup colours associated with relevant labels for priority, effort required and status/progress: