Template:Feature tracking: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (→‎Usage: tweak usage, document Priority 9 and 5)
(→‎Usage: mention obsolete name parameter)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>
<includeonly>
{{Definition_table
{{Definition_table
|Short name|{{ #if: {{{Name|}}} | [[Short name::{{{Name|Untitled feature}}}]] ''(should match page title)'' | <font color=#aaa>Please provide short name matching title</font>}}
|Feature subcategory|{{ #if: {{{Feature subcategory|}}} |[[Is part of::Category:{{{Feature subcategory}}}]] [[Category:{{{Feature subcategory}}}]] | <font color=#aaa>Please provide feature subcategory</font>}}
|Feature subcategory|{{ #if: {{{Feature subcategory|}}} |[[Is part of::Category:{{{Feature subcategory}}}]] [[Category:{{{Feature subcategory}}}]] | <font color=#aaa>Please provide feature subcategory</font>}}
|Requesters | {{#arraymap:{{{Requesters|}}}|,|x|[[Requested by::x]]}} {{#if: {{{Requesters|}}}||<font color=#aaa>Please indicate countries or engineers making the request</font>}}
|Requesters | {{#arraymap:{{{Requesters|}}}|,|x|[[Requested by::x]]}} {{#if: {{{Requesters|}}}||<font color=#aaa>Please indicate countries or engineers making the request</font>}}
Line 20: Line 19:
<pre>
<pre>
{{Feature_tracking
{{Feature_tracking
|Name=A brief less-than-one-line summary of the feature, used as the title
|Feature subcategory=A subcategory of [[Category:Software features]]
|Feature subcategory=A subcategory of [[Category:Software features]]
|Requesters=Deployments, engineers, or both who support the request
|Requesters=Deployments, engineers, or both who support the request (separated by commas)


|Requirements=User-level requirement definition; Links to detailed wiki pages, mailing list threads, or other resources are welcome
|Requirements=User-level requirement definition; Links to detailed wiki pages, mailing list threads, or other resources are welcome
Line 35: Line 33:
*of relevant links
*of relevant links


|Owners=Names of developers and/or champions of the request who will ensure that progress is made
|Owners=Names of developers and/or champions of the request who will ensure that progress is made (separated by commas)


|Priority=9 (9=unassigned 1 = Critical,2 = High,3 = Medium, 4 = Low, 5 = not needed)
|Priority=9 (9=unassigned 1 = Critical,2 = High,3 = Medium, 4 = Low, 5 = not needed)
Line 41: Line 39:
|Target for 9.1=yes or no
|Target for 9.1=yes or no
}}</pre>
}}</pre>

(The template used to have a ''Name'' parameter, but this is now unused. You can remove it from invocations of the template, though it doesn't hurt to leave it in.)


== Sample ==
== Sample ==


{{Feature_tracking
{{Feature_tracking
|Name=A brief less-than-one-line summary of the feature, used as the title
|Feature subcategory=XTest feature
|Feature subcategory=XTest feature
|Requesters=User:St. NickN, OLPC Antarctica
|Requesters=User:St. NickN, OLPC Antarctica

Latest revision as of 12:39, 21 December 2008

Enables a dynamic Feature roadmap — see Semantic MediaWiki#For software features.

Displays a feature's values and also defines its semantics for the Feature_roadmap. It's based on {{Feature request}} (will some day replace it), but displays several extra feature properties, and makes semantic annotations of them. Both templates use {{Definition table}} to lay display

Usage

{{Feature_tracking
|Feature subcategory=A subcategory of [[Category:Software features]]
|Requesters=Deployments, engineers, or both who support the request (separated by commas)

|Requirements=User-level requirement definition; Links to detailed wiki pages, mailing list threads, or other resources are welcome
*or
*a
*list
*of
*them

|Specification=Design and technical implementation ideas; Links to detailed wiki pages, mailing list threads, or other resources are welcome
*or a list
*of relevant links

|Owners=Names of developers and/or champions of the request who will ensure that progress is made (separated by commas)

|Priority=9 (9=unassigned 1 = Critical,2 = High,3 = Medium, 4 = Low, 5 = not needed)
|Helps deployability=yes or no
|Target for 9.1=yes or no
}}

(The template used to have a Name parameter, but this is now unused. You can remove it from invocations of the template, though it doesn't hurt to leave it in.)

Sample

Feature subcategory Is part of::Category:XTest feature
Requesters {{#arraymap:User:St. NickN, OLPC Antarctica|,|x|Requested by::x}}
Requirements User level requirement definition; Links to detailed wiki pages, mailing list threads, or other resources are welcome
  • or
  • a
  • list
  • of
  • them
Specification Design and technical implementation ideas; Links to detailed wiki pages, mailing list threads, or other resources are welcome
  • or a list
  • of relevant links
Owners {{#arraymap:John Doe, Jane Doe|,|x|Contact person::User:x}}
Priority Priority::4
Helps deployability? Helps deployability::no
Target for 9.1? Target for 9.1::no

Pre-filling

Pages like Feature roadmap and Features-test can use <inputbox to pre-fill a new page with the contents in Template:Feature tracking/Preload (which is the default text above. This helps less experienced editors to use Template:Feature tracking appropriately.