Template:Tracked/doc
This is a documentation subpage for Template:Tracked. It contains usage information, categories, and other content that is not part of the original template page. |
This template uses TemplateStyles: |
This template is intended to be used on feedback pages and talk pages for software deployments. It floats right-aligned next to whichever content it precedes. Imagine we see a comment like the following:
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST) |
Now let's say we want to note that there's a task on Phabricator for this. We'll add the following code: {{tracked|T123}}
(where T123 is the identifier of the task).
Sample output:
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST) |
We can leave it at that. If we'd like to note the fact that the task's been resolved, we can note its status, via {{tracked|T123|resolved}}
. In addition to resolved
, we support invalid
, duplicate
, declined
, stalled
and open
. Example with the resolved
keyword:
Sample output:
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST) |
Of course, feel free to avoid using this template if tracking a comment is not useful.
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST)
|
Bugzilla tickets
editFor backwards compatibility, this template also accepts the number of a Bugzilla ticket as the first parameter, and the following resolutions: fixed
, wontfix
, later
, invalid
. Last but not least, we can mark a bug as critical. We deliberately aren't using this keyword for bugs which are resolved one way or another -- the point of adding this to the template is to note to all readers of the page that the seriousness of a bug has been critical. This keyword should only be used if the bug has also been marked as critical in Bugzilla. Example usage: {{Tracked|300|critical}}
Sample output:
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST) |
If you need the Phabricator task for a migrated Bugzilla ticket, add 2000 to the BZ bug number and prefix with T, e.g., T2300 replaced bugzilla:300.
See also
edit- {{Phab}}, inline link
- {{Bug}}, inline link (deprecated)
- {{Bugzilla}}, inline link (multiple items)
- {{Ptag}}, link to Phabricator projects
Link box to a bug report
Parameter | Description | Type | Status | |
---|---|---|---|---|
Bug id. | 1 | Tasknumber T123 or old bugzilla number | Line | required |
Status | 2 | For a task: open, stalled, done (or resolved), invalid, duplicate, declined, ... For a bug: critical, done (or fixed), later, wontfix (or won't fix), invalid, duplicate, ... | Line | optional |
float | float | CSS float+clear
| Line | optional |