Template:Module rating/doc

Revision as of 05:33, 12 December 2021 by [[w:]]>Alexis Jazz (→‎Usage)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

[[Category:Template documentation pages{{#translation:}}]]

This template is used to rate Lua modules by quality. It is placed at the top of the module's /doc subpage. It produces a message informing users about the rating system, and it also places the module into a tracking category.

Usage

Basic usage:

<templatestyles src="Pre/styles.css"/>

<templatestyles src="Template:Mono/styles.css"/>{{module rating|rating}}

Without categories:

<templatestyles src="Pre/styles.css"/>

<templatestyles src="Template:Mono/styles.css"/>{{module rating|rating|nocat=true}}

If <templatestyles src="Template:Mono/styles.css"/>{{Module rating}} is used outside the Module namespace, an error message is displayed instead and will be categorized under Category:Pages with templates in the wrong namespace.

If the documentation subpage is also protected:

<templatestyles src="Pre/styles.css"/>

<templatestyles src="Template:Mono/styles.css"/>{{module rating|rating|reason for documentation protection|action for documentation protection}}

The second and third unnamed arguments correspond to reason and action of {{Pp}} which gets included on the documentation subpage if at least the second unnamed argument is present.

Ratings

The rating should be placed in the first positional parameter. There are six different ratings: pre-alpha, alpha, beta, release, and protected, and semiprotected. There are also short alias codes for each of the ratings.

Rating Aliases Result
pre-alpha prealpha
pa
alpha a
beta b
release r
general
g
protected protect
p
semiprotected semiprotect
semi
Anything else or if missing

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Module rating

[[Category:TemplateData documentation{{#translation:}}]]

This template is used to rate Lua modules by quality. It is placed at the top of the module's /doc subpage. It produces a message informing users about the rating system, and it also places the module into a tracking category.
⧼templatedata-doc-param-name⧽⧼templatedata-doc-param-desc⧽⧼templatedata-doc-param-type⧽⧼templatedata-doc-param-status⧽
Rating1
One of 'pre-alpha', 'alpha', 'beta', 'release', 'protected' or 'semiprotected', or an approved (see full docs) abbreviation for one of these. As quality ratings, 'protected' and 'semiprotected' can be considered equivalent to 'release', with editing restrictions.
⧼templatedata-doc-param-suggestedvalues⧽
pre-alpha alpha beta release protected semiprotected
⧼templatedata-doc-param-type-string⧽⧼templatedata-doc-param-status-required⧽
Do not categorizenocat
Set to true to disable categorization by rating. Normally leave blank.
⧼templatedata-doc-param-autovalue⧽
true
⧼templatedata-doc-param-type-boolean⧽⧼templatedata-doc-param-status-optional⧽
Fake namespacedemospace
Set to module to force template to display outside that namespace. Demonstration purposes only.
⧼templatedata-doc-param-example⧽
module
⧼templatedata-doc-param-type-string⧽⧼templatedata-doc-param-status-optional⧽

Format: inline

Categories

The template will put modules in one of the following categories, according to the rating specified:

These categories are suppressed on pages ending with /doc. To suppress categories on all pages, you can use the code <templatestyles src="Template:Nowrap/styles.css"/>|nocat=true.

See also