You are browsing a read-only backup copy of Wikitech. The live site can be found at

Phabricator project: [[phab:tag/{{{phabricator}}}/|#{{{phabricator}}}]]


From Wikitech-static
< Template:Tool
Revision as of 07:04, 4 February 2017 by imported>Legoktm (→‎Usage: don't tell people to c/p "templatemode")
Jump to navigation Jump to search

Lua error in Module:TNT at line 158: Missing JsonConfig extension; Cannot load Tool is a template for documenting Tool Labs tools.


Copy and paste:

|name         =
|title        =
|description  =
|website      =
|keywords     =
|author       =
|username     =
|maintainer   =
|repository   =
|license      =
|image        =
|phabricator  =
|bugzilla     =
|issues       =
|sal          =
|icon         =

For help with parameter values, see below.

Toolforge tools
Crystal Clear app package utilities.png {{{title}}}
Website {{{website}}}
Description {{{description}}}
Keywords {{{keywords}}}
Author(s) SomeAuthor (SomeUsertalk)
Maintainer(s) SomeMaintainer ([[toolforge:admin/tool/{{{name}}}|View all]])
Source code {{{repository}}}
License {{{license}}}
Issues [[phab:tag/{{{phabricator}}}|Open tasks]] · Report a bug
Admin log {{{sal}}}

Template parameters

<templatedata> { "params": { "name": { "label": "Name", "description": "Name of tool", "example": "my-tool", "type": "string", "required": true, "suggested": true }, "title": { "label": "Title", "description": "Title of tool", "example": "My awesome tool", "type": "string", "suggested": true }, "description": { "label": "Description", "description": "Short description of tool", "example": "Lookup things about stuff that really matters", "type": "string", "suggested": true }, "website": { "label": "URL", "description": "URL to tool's user interface or documentation", "example": "my-tool", "type": "url", "suggested": true }, "keywords": { "label": "Keywords", "description": "Keywords related to tool", "example": "lookup, patroller, bot", "type": "string", "suggested": true }, "repository": { "label": "Repository", "description": "URL to version control for tool", "example": "", "type": "url", "suggested": true }, "license": { "label": "License", "description": "OSI-approved license of tool's source code", "example": "GPL-2.0+", "type": "string", "suggested": true }, "phabricator": { "label": "Phabricator", "description": "Phabricator project name", "example": "Tool-Labs-Tool-Mytool", "type": "string" }, "bugzilla": { "label": "Bugzilla", "description": "Bugzilla component", "example": "Mytool", "type": "string", "deprecated": "Use Phabricator instead" }, "issues": { "label": "Issue tracker", "description": "URL to issue tracker if not using Phabricator", "type": "url" }, "author": { "label": "Author(s)", "description": "Tool authors", "example": "Some Author, Another Author", "type": "string", "suggested": true }, "username": { "label": "Username", "description": "Wikitech username of solo author", "example": "SomeUser", "type": "wiki-user-name", "suggested": true }, "templatemode": { "type": "string", "description": "Hack for displaying template on documentation page", "example": "nocats" }, "image": { "label": "Image", "description": "Image representing tool or screenshot", "type": "wiki-file-name", "suggested": true }, "maintainer": { "label": "Maintainer", "description": "Tool maintainers", "type": "string" }, "sal": { "label": "Server Admin Log", "description": "Link to server admin log for tool", "example": "Nova_Resource:Tools.stashbot/SAL", "type": "content" }, "icon": { "label": "Icon", "description": "Icon in the top left corner of the template.", "type": "wiki-file-name", "default": "Crystal_Clear_app_package_utilities.png" } }, "paramOrder": [ "name", "title", "description", "website", "keywords", "author", "username", "maintainer", "repository", "license", "image", "phabricator", "bugzilla", "issues", "sal", "templatemode", "icon" ], "format": "block", "description": "Describes a Tool Labs tool (or a tool hosted elsewhere)" } </templatedata>