Template:Module rating/doc: Difference between revisions

Revision as of 23:48, 22 September 2018

This is a documentation subpage for Template:Module rating.
It may contain usage information, categories and other content that is not part of the original template page.

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:

{{module rating|rating}}

Without categories:

{{module rating|rating|nocat=true}}

If {{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.

Ratings

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

Rating Aliases Result

pre-alpha

prealpha
pa

This module is rated as pre-alpha. It is unfinished, and may or may not be in active development. It should not be used from article namespace pages. Modules remain pre-alpha until the original editor (or someone who takes one over if it is abandoned for some time) is satisfied with the basic structure.

alpha

a

This module is rated as alpha. It is ready for third-party input, and may be used on a few pages to see if problems arise, but should be watched. Suggestions for new features or changes in their input and output mechanisms are welcome.

beta

b

This module is rated as beta, and is ready for widespread use. It is still new and should be used with some caution to ensure the results are as expected.

release

r
general
g

This module is rated as ready for general use. It has reached a mature form and is thought to be bug-free and ready for use wherever appropriate. It is ready to mention on help pages and other Wikipedia resources as an option for new users to learn. To reduce server load and bad output, it should be improved by sandbox testing rather than repeated trial-and-error editing.

protected

protect
p

This module is subject to page protection. It is a highly visible module in use by a very large number of pages, or is substituted very frequently. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is protected from editing.

semiprotected

semiprotect
semi

This module is subject to page protection. It is a highly visible module in use by a very large number of pages, or is substituted very frequently. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is semi-protected from editing.

Anything else or if missing

Module rating is invalid or not specified.

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for Module rating

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.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Rating	`1`	One of pre-alpha, alpha, beta or release for quality, or one of protected or semiprotected, or an approved (see full docs) abbreviation for one of these. Example release	String	required
Do not categorize	`nocat`	Set to true to disable categorization by rating. Normally leave blank. Default Not set.	Boolean	optional
Fake namespace	`demospace`	Set to module to force template to display outside that namespace. Demonstration purposes only. Default Not set. Example module	String	optional

@@ Line 15: / Line 15: @@
 If {{tlx|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]].
+== Ratings ==
+The rating should be placed in the first positional parameter. There are five different ratings: '''pre-alpha''', '''alpha''', '''beta''', '''release''', and '''protected'''. There are also short alias codes for each of the ratings.
+{| class="wikitable"
+! Rating !! Aliases !! Result
+|-
+| <code>pre-alpha</code> || <code>prealpha</code><br/><code>pa</code> || {{module rating|pre-alpha|nocat=true|demospace=Module}}
+|-
+| <code>alpha</code> || <code>a</code> || {{module rating|alpha|nocat=true|demospace=module}}
+|-
+| <code>beta</code> || <code>b</code> || {{module rating|beta|nocat=true|demospace=module}}
+|-
+| <code>release</code> || <code>r</code><br/><code>general</code><br/><code>g</code> || {{module rating|release|nocat=true|demospace=module}}
+|-
+| <code>protected</code> || <code>protect</code><br/><code>p</code> || {{module rating|protected|nocat=true|demospace=module}}
+|-
+| <code>semiprotected</code> || <code>semiprotect</code><br/><code>semi</code> || {{module rating|semi|nocat=true|demospace=module}}
+|-
+| ''Anything else or if missing'' ||  || {{module rating|prdaskidkated|nocat=true|demospace=module}}
+|-
+|}
+==Template data==
 {{TemplateDataHeader}}
@@ Line 47: / Line 72: @@
-== Ratings ==
-The rating should be placed in the first positional parameter. There are five different ratings: '''pre-alpha''', '''alpha''', '''beta''', '''release''', and '''protected'''. There are also short alias codes for each of the ratings.
-{| class="wikitable"
-! Rating !! Aliases !! Result
-|-
-| <code>pre-alpha</code> || <code>prealpha</code><br/><code>pa</code> || {{module rating|pre-alpha|nocat=true|demospace=Module}}
-|-
-| <code>alpha</code> || <code>a</code> || {{module rating|alpha|nocat=true|demospace=module}}
-|-
-| <code>beta</code> || <code>b</code> || {{module rating|beta|nocat=true|demospace=module}}
-|-
-| <code>release</code> || <code>r</code><br/><code>general</code><br/><code>g</code> || {{module rating|release|nocat=true|demospace=module}}
-|-
-| <code>protected</code> || <code>protect</code><br/><code>p</code> || {{module rating|protected|nocat=true|demospace=module}}
-|-
-| <code>semiprotected</code> || <code>semiprotect</code><br/><code>semi</code> || {{module rating|semi|nocat=true|demospace=module}}
-|-
-| ''Anything else or if missing'' ||  || {{module rating|prdaskidkated|nocat=true|demospace=module}}
-|-
-|}
 == Categories ==

Template:Module rating/doc: Difference between revisions

Revision as of 23:48, 22 September 2018

Contents

Usage

Ratings

Template data

Categories

See also

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools

In other languages