Template:Docparam/doc

From Sly Cooper Wiki
Jump to navigation Jump to search
This page contains usage information for Template:Docparam.

Template:Docparam is used to document parameters in template documentation pages. It provides all the necessary information about a parameter and should be used on all template documentations with parameters.

Usage

{{docparam |name= |req= |default= |default2= |desc=

}}

Parameters

Icon required.png

name

Name of the parameter. Certain strings are automatically translated to allow for specification of alternative choices or parameter ranges.

Translated strings (all of these need to be enclosed by spaces):

  • >> is converted "up to", to indicate a range of possible parameters.
  • // is converted to "or", for alternative choices.
  • ++ is converted to a comma with a trailing space (", "), for listing parameters which are separate but work the same (e.g. "contentA1, contentB1").

Icon required.png

req
(default: "no" )

Indicates whether the parameter is required by policy or for the template to function properly, as follows:

  • no — Optional parameter.
  • semi — Semi-required parameter; optional in some situations but required in others, or highly recommended.
  • yes — Required parameter.

Icon optional.png

default up to default2

Indicates whether there is a default value for a parameter if it is left empty.

Icon required.png

desc

The description of the parameter (as in this line of text). This section should include all necessary details pertaining to the use, guidelines, and policies of a certain parameter.