Template:Template rating

Template documentation[view] [edit] [history] [purge]

This template should not be substituted.

English Wikipedia has an article on:

Template:Template rating

Template:Template rating is used to denote the rating of a template or module, namely denoting whether or not it can be used. This template is placed within the documentation page of a template, not its <noinclude></noinclude> block.

Despite the name, this template can also be used on Lua modules' documentation pages.

Parameters

rating (required; default draft)

The rating of template or module.

namespace (automatically detected using {{ARTICLESPACE}})

The namespace of the page. For normal use, this is automatically detected and does not need to be entered manually.

pagename (automatically detected using {{PAGENAME}})

The name of the page. For normal use, this is automatically detected and does not need to be entered manually.

details (optional)

Any details about the template or module in question.

replacement (required if rating=replaced)

The name of the replacement template or module, if the current template or module is being replaced by a new one.

delete (required if rating=replaced or rating=deprecated; default false)

Whether to delete the template or module, if the current template or module is being either replaced or deprecated. Deprecated templates and modules are generally kept for archival and historical purposes, but those that have seen little use (such as those made for testing or with experimental features) may be deleted instead.

debug (optional; default false)

Whether to disable categories for Template:Category handler. For normal use, this should be left unchanged.

Quick copy (essential params only)

{{Template rating
| rating      =
| details     =
| replacement =
| delete      =
}}

Usage

The following examples assumes use for a template. Usage within the module namespace is automatically detected.

Draft template

Ready denotes a template that is work-in-progress, or templates that are being rewritten or refactored.

{{Template rating|Sometemplate|rating=draft|details=Other details go here.}} {{#switch: draft

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for Template:Template rating. Details: Other details go here.

Ready template

Ready denotes a template that is ready for use on the wiki. The use of this template is not necessary for most templates, as a template without any other indicators is assumed to be a ready template.

{{Template rating|Sometemplate|rating=ready|details=Other details go here.}} {{#switch: ready

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for Template:Template rating. Details: Other details go here.

Broken template

Broken denotes a template that is not functioning properly and is currently being fixed. For templates that work but are undergoing refactoring, use the draft rating.

{{Template rating|Sometemplate|rating=broken|details=Other details go here.}} {{#switch: broken

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for Template:Template rating. Details: Other details go here.

Replaced template

Replaced denotes a template that should no longer be used and have been superseded by a new template. By default, deprecated templates are not nominated for deletion, as deleting a deprecated template makes viewing past revisions of transcluding pages much more difficult.

{{Template rating|Sometemplate|rating=replaced|replacement=Somenewtemplate|details=Other details go here.}} {{#switch: replaced

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. Editors are advised to use its replacement: Template:Somenewtemplate Details: Other details go here.

If a template has not been extensively used, it may be nominated for deletion by adding delete=1.

{{Template rating|Sometemplate|rating=replaced|replacement=Somenewtemplate|details=Other details go here.|delete=1}} {{#switch: replaced

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. Editors are advised to use its replacement: Template:Somenewtemplate Details: Other details go here.

Deprecated template

Deprecated denotes a template that should no longer be used and has no replacement.

{{Template rating|Sometemplate|rating=deprecated|details=Other details go here.}} {{#switch: deprecated

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for Template:Template rating. Details: Other details go here.

As with replaced templates, deprecated templates are not nominated for deletion by default. To nominate it for deletion, add delete=1.

{{Template rating|Sometemplate|rating=deprecated|details=Other details go here.|delete=1}} {{#switch: deprecated

| draft =

Template:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| ready =

Template:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended. Details: Other details go here.

| broken =

Template:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing. Details: Other details go here.

| deprecated =

Template:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for Template:Template rating. Details: Other details go here.

Incorrect options and categories

This template uses Template:Category handler, which categories templates and modules using this template in the appropriate categories, except those with a rating of ready. Categories are not enabled on /doc or /sandbox pages.

In addition to this, this template detects whether it's in the incorrect namespace, such as when used on User namespace pages, and can detect whether it has an unrecognized rating.

{{Template rating|Sometemplate|rating=aaa}} {{#switch: aaa

| draft =

User:Template rating is a draft template. It is incomplete and may not necessarily be in active development. In the meantime, editors are advised to not use this template across the wiki, except for testing.

| ready =

User:Template rating is a template that is ready to be used on the wiki. This message indicates that a template is ready for use, or has recently been repaired. This message may be removed once the template has been used on several pages or once it is verified to work as intended.

| broken =

User:Template rating is currently broken. If possible, editors are encouraged to improve it or nominate it for deletion or deprecation if it cannot be fixed. In the meantime, editors are advised to not use this template across the wiki, except for testing.

| deprecated =

User:Template rating is deprecated. Further use of this template is not advised. This page may be deleted. No replacement exists for User:Template rating.

See also

• Template:Deprecated template, a template added to a deprecated template's code, to be used in conjunction with this template