Difference between revisions of "Template:Cleanup/doc"

From blackwiki
Jump to navigation Jump to search
imported>Fuzheado
m (Reverted edits by 174.215.160.104 (talk) (HG) (3.4.10))
 
(63 intermediate revisions by 48 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
{{Substitution| |only if you want to automatically add the "date{{=}}" parameter}}
 
{{Substitution| |only if you want to automatically add the "date{{=}}" parameter}}
{{high-use|15205}}
+
{{high-use|12993}}
 
{{Twinkle standard installation}}
 
{{Twinkle standard installation}}
 
{{Lua|Module:Unsubst}}
 
{{Lua|Module:Unsubst}}
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
  
== Post Articles on [[WP:CLEAN]] ==
+
== Post articles on WikiProject Cleanup ==
If you feel that your article needs a significant amount of cleanup, you can post articles on [[WP:CLEAN]] (Project Cleanup) to hav`je them cleaned by users. It is more effective than tagging as there is a backlog for the tags. Editors will give your submitted article a cleanup and fix any problems associated with it. Please submit at [[WP:CLEAN]].
+
If you feel that your article needs a significant amount of cleanup, you can post articles on [[WP:CLEAN]] (Project Cleanup) to have them cleaned by users. It is more effective than tagging as there is a backlog for the tags. Editors will give your submitted article a cleanup and fix any problems associated with it. Please submit at [[WP:CLEAN]].
 +
 
 
== Usage ==
 
== Usage ==
 
{{Tlc|{{ROOTPAGENAME}}}} should be used with the following two parameters:
 
{{Tlc|{{ROOTPAGENAME}}}} should be used with the following two parameters:
 +
* {{para|date}}: the month and year (e.g. {{CURRENTMONTHNAME}} {{CURRENTYEAR}}) when the Cleanup template was added to the article; this helps to figure out how long an article has been tagged for cleanup.
 
* {{para|reason}}: the reason for requesting cleanup. This is useful for editors in case the reason for requesting a cleanup is not immediately obvious.
 
* {{para|reason}}: the reason for requesting cleanup. This is useful for editors in case the reason for requesting a cleanup is not immediately obvious.
* {{para|date}}: the month and year (e.g. {{CURRENTMONTHNAME}} {{CURRENTYEAR}}) when the Cleanup template was added to the article; this helps to figure out how long an article has been tagged for cleanup.
 
  
 
Optional parameters include:
 
Optional parameters include:
* the first parameter: changes the default descriptor (i.e. "Article"). Example tl|Cleanup|section changes it to "Section". A wrapper is {{tl|Cleanup section}}  
+
* {{para|talk}} or {{para|talksection}}: the section of the talk page explaining what needs to be done. Add a new section to the talk page explaining the type and extent of clean-up required, so editors will know what to address and when to remove this template.
* {{para|talksection}}: the section of the talk page explaining what needs to be done. Add a new section to the talk page explaining the type and extent of clean-up required so editors will know what to address, and when to remove this template.
+
* {{para|1}} (or an empty parameter): changes the default descriptor (i.e., "article"). For example, {{tlx|Cleanup|section}} changes it to "section".
 +
* {{para|small}}: enter 'left' here to turn the template into a small box on the left side of the screen.
 +
* {{para|nocat}}: enter 'true' here to prevent the template from adding cleanup categories to the article.
  
 
The template should be placed at the top of the article requiring a cleanup. If practicable, please use a [[Wikipedia:Template messages/Cleanup|more specific cleanup template]]. Because {{Tlc|{{ROOTPAGENAME}}}} is vague, specific problems should be identified in the <code>reason</code> field; a more detailed explanation of what needs to be done can be provided on the article's talk page. An article's {{Tlc|{{ROOTPAGENAME}}}} template may be removed without the problems being fixed if it is not possible to identify what needs to be cleaned up.
 
The template should be placed at the top of the article requiring a cleanup. If practicable, please use a [[Wikipedia:Template messages/Cleanup|more specific cleanup template]]. Because {{Tlc|{{ROOTPAGENAME}}}} is vague, specific problems should be identified in the <code>reason</code> field; a more detailed explanation of what needs to be done can be provided on the article's talk page. An article's {{Tlc|{{ROOTPAGENAME}}}} template may be removed without the problems being fixed if it is not possible to identify what needs to be cleaned up.
Line 101: Line 104:
 
<templatedata>
 
<templatedata>
 
{
 
{
 +
"description": "This tag is intended to identify pages that need wikification or the correction of spelling, grammar, typographical errors, tone, and other similar, non-content-focused changes. Use this tag when the article needs improvement per WP:BETTER.",
 +
"format": "inline",
 
"params": {
 
"params": {
"1": {
+
"date": {
"label": "Type",
+
"label": "Month and year",
"description": "Type of page (e.g. article) or section",
+
"description": "Month and year the template was added to the page",
"type": "string"
+
"type": "string",
 +
"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
 +
"example": "January 2018",
 +
"required": true
 
},
 
},
 
"reason": {
 
"reason": {
Line 113: Line 121:
 
"label": "Reason",
 
"label": "Reason",
 
"description": "Reason for requesting cleanup",
 
"description": "Reason for requesting cleanup",
"example": "the article is full of incorrect capitalization",
 
 
"type": "string",
 
"type": "string",
 +
"example": "The article is full of incorrect capitalization.",
 
"required": true
 
"required": true
 
},
 
},
"nocat": {
+
"talk": {
"type": "string",
+
"aliases": [
"label": "No category",
+
"talksection"
"description": "Suppress categorization",
+
],
"example": "true"
+
"label": "Talk page section",
 +
"description": "The section of the talk page explaining what needs to be done",
 +
"type": "string"
 
},
 
},
 
"small": {
 
"small": {
 
"label": "Small",
 
"label": "Small",
"description": "Small format",
+
"description": "Enter 'left' here to turn the template into a small box on the left side of the screen.",
"example": "left",
+
"type": "string",
"type": "string"
+
"autovalue": "left",
 +
"example": "left"
 
},
 
},
"talk": {
+
"1": {
 +
"label": "Type (e.g., section)",
 +
"description": "Text to replace the word \"article\", usually \"section\"",
 
"type": "string",
 
"type": "string",
"aliases": [
+
"autovalue": "section",
"talksection"
+
"example": "section"
],
 
"label": "Talk page section",
 
"description": "the section of the talk page explaining what needs to be done"
 
 
},
 
},
"date": {
+
"nocat": {
"label": "Date",
+
"label": "No category",
"description": "Date the template was added to the page",
+
"description": "Suppress categorization",
"example": "January 2018",
 
 
"type": "string",
 
"type": "string",
"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
+
"autovalue": "true",
"required": true
+
"example": "true"
 
}
 
}
 
},
 
},
"description": "This tag is intended to identify pages that need wikification or the correction of spelling, grammar, typographical errors, tone, and other similar, non-content-focused changes. Use this tag when the article needs improvement per WP:BETTER.",
 
 
"paramOrder": [
 
"paramOrder": [
 
"date",
 
"date",
Line 154: Line 162:
 
"1",
 
"1",
 
"nocat"
 
"nocat"
],
+
]
"format": "inline"
 
 
}
 
}
 
</templatedata>
 
</templatedata>
 +
 
<includeonly>{{sandbox other||
 
<includeonly>{{sandbox other||
 
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
 
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->

Latest revision as of 00:45, 7 November 2020

Post articles on WikiProject Cleanup

If you feel that your article needs a significant amount of cleanup, you can post articles on WP:CLEAN (Project Cleanup) to have them cleaned by users. It is more effective than tagging as there is a backlog for the tags. Editors will give your submitted article a cleanup and fix any problems associated with it. Please submit at WP:CLEAN.

Usage

{{Cleanup}} should be used with the following two parameters:

  • |date=: the month and year (e.g. December 2025) when the Cleanup template was added to the article; this helps to figure out how long an article has been tagged for cleanup.
  • |reason=: the reason for requesting cleanup. This is useful for editors in case the reason for requesting a cleanup is not immediately obvious.

Optional parameters include:

  • |talk= or |talksection=: the section of the talk page explaining what needs to be done. Add a new section to the talk page explaining the type and extent of clean-up required, so editors will know what to address and when to remove this template.
  • |1= (or an empty parameter): changes the default descriptor (i.e., "article"). For example, {{Cleanup|section}} changes it to "section".
  • |small=: enter 'left' here to turn the template into a small box on the left side of the screen.
  • |nocat=: enter 'true' here to prevent the template from adding cleanup categories to the article.

The template should be placed at the top of the article requiring a cleanup. If practicable, please use a more specific cleanup template. Because {{Cleanup}} is vague, specific problems should be identified in the reason field; a more detailed explanation of what needs to be done can be provided on the article's talk page. An article's {{Cleanup}} template may be removed without the problems being fixed if it is not possible to identify what needs to be cleaned up.

If this template is substituted, the end result consists of an unsubstituted form including an automatically filled date= parameter with the current date.

When to use

This tag is intended to identify pages that need wikification or the correction of spelling, grammar, typographical errors, tone, and other similar, non-content-focused changes. Use this tag when the article needs improvement per WP:BETTER.

Articles that violate policy need more direct action. Other templates, such as {{POV}}, are better suited to content disputes.

Alternative

If the problem is correctable with the skills you already possess, consider being bold and fixing it yourself, rather than applying this template and leaving it for someone else to clean up.

Examples

For example, {{Cleanup|reason=the article is full of incorrect capitalization.|date=December 2025}} would display as:

The template detects which namespace it is used in and changes accordingly:
Article
Category
Template

The descriptor (on the preceding example "template") can be changed from its default using the first parameter, for instance {{Cleanup|section}} or {{Cleanup|disambiguation page}}.

Categorization

This template will add pages on which it is used to a specific category Category:Articles needing cleanup containing pages needing cleanup or a dated subcategory thereof.

Tracking categories

For tracking purposes it also categorises the page according to whether a reason code has been given.

See also

Redirects

Wrappers

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Cleanup

This tag is intended to identify pages that need wikification or the correction of spelling, grammar, typographical errors, tone, and other similar, non-content-focused changes. Use this tag when the article needs improvement per WP:BETTER.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Month and yeardate

Month and year the template was added to the page

Example
January 2018
Auto value
{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}
Stringrequired
Reasonreason 2

Reason for requesting cleanup

Example
The article is full of incorrect capitalization.
Stringrequired
Talk page sectiontalk talksection

The section of the talk page explaining what needs to be done

Stringoptional
Smallsmall

Enter 'left' here to turn the template into a small box on the left side of the screen.

Example
left
Auto value
left
Stringoptional
Type (e.g., section)1

Text to replace the word "article", usually "section"

Example
section
Auto value
section
Stringoptional
No categorynocat

Suppress categorization

Example
true
Auto value
true
Stringoptional