Template:Feature tracking: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (use {{SMW for software features}})
(→‎Usage: mention obsolete name parameter)
 
(5 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
|Feature subcategory=A subcategory of [[Category:Software features]]
|Name=A brief less-than-one-line summary of the feature, used as the title
|Requesters=Deployments, engineers, or both who support the request (separated by commas)
|Feature subcategory=A subcategory of <nowiki>[[Category:Software features]]</nowiki>
|Requesters=Deployments, engineers, or both who support the request


|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
*or
*or
*a
*a
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=1 - Critical,2 - High,3 - Medium, or 4 - Low
|Priority=9 (9=unassigned 1 = Critical,2 = High,3 = Medium, 4 = Low, 5 = not needed)
|Helps deployability=yes or no
|Helps deployability=yes or no
|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.)
Priority is restricted to the values listed on the [[Property:Priority]] page.


== 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
Line 61: Line 58:
|Owners=John Doe, Jane Doe
|Owners=John Doe, Jane Doe


|Priority=4 - Low
|Priority=4
|Helps deployability=no
|Helps deployability=no
|Target for 9.1=no
|Target for 9.1=no
Line 67: Line 64:


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


[[Category:Template]]
[[Category:Template]]

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.