Difference between revisions of "Template:Cleanup/doc"
(www. Google. Com) |
imported>Calumapplepie (Undid revision 900005112 by 2402:3A80:D3E:C447:1724:D31B:47:6308 (talk) for deleting all the documentation of a key template) |
||
| Line 1: | Line 1: | ||
| + | {{Documentation subpage}} | ||
| + | {{Substitution| |only if you want to automatically add the "date{{=}}" parameter}} | ||
| + | {{high-use|15205}} | ||
| + | {{Twinkle standard installation}} | ||
| + | {{Lua|Module:Unsubst}} | ||
| + | <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> | ||
| + | == Post Articles on [[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 == | ||
| + | {{Tlc|{{ROOTPAGENAME}}}} should be used with the following two parameters: | ||
| + | * {{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: | ||
| + | * 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|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. | ||
| + | |||
| + | 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. | ||
| + | |||
| + | If this template is [[Wikipedia:Subst|substituted]], the end result consists of an unsubstituted form including an automatically filled <code>date=</code> 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 {{tl|POV}}, are better suited to content disputes. | ||
| + | |||
| + | === Alternative === | ||
| + | If the problem is correctable with the skills you already possess, consider being [[WP:SOFIXIT|bold]] and fixing it yourself, rather than applying this template and leaving it for someone else to clean up. | ||
| + | |||
| + | == Examples == | ||
| + | For example, {{Tlc|{{ROOTPAGENAME}}|reason{{=}}the article is full of incorrect capitalization.|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} would display as: | ||
| + | {{Cleanup|article|reason=the article is full of incorrect capitalization.|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|demospace=main|nocat=true}} | ||
| + | |||
| + | {| class="wikitable" | ||
| + | |+ The template detects which [[Wikipedia:Namespace|namespace]] it is used in and changes accordingly: | ||
| + | ! Article | ||
| + | | {{Cleanup|article|reason=lorem ipsum dolor sit amet.|demospace=main|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|nocat=true}} | ||
| + | |- | ||
| + | ! Category | ||
| + | | {{Cleanup|category|reason=lorem ipsum dolor sit amet!|demospace=category|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|nocat=true}} | ||
| + | |- | ||
| + | ! Template | ||
| + | | {{Cleanup|template|reason=lorem ipsum dolor sit amet?|demospace=other|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|nocat=true}} | ||
| + | |} | ||
| + | |||
| + | The descriptor (on the preceding example "template") can be changed from its default using the first parameter, for instance {{Tlc|Cleanup|section}} or {{Tlc|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 === | ||
| + | * {{clc|All pages needing cleanup}} | ||
| + | |||
| + | For tracking purposes it also categorises the page according to whether a reason code has been given. | ||
| + | |||
| + | == See also == | ||
| + | * {{Tl|Cleanup AfD}} – For AfD discussions that closed as "keep", but require cleanup | ||
| + | * {{Tl|Cleanup image}} – For images that need cleanup | ||
| + | * {{Tl|Cleanup reorganize}} – For articles that need a reorganization in addition to cleanup | ||
| + | * {{Tl|Cleanup see also}} – For "See also" sections | ||
| + | * {{Tl|Multiple issues}} | ||
| + | * {{Tl|Spacing}} | ||
| + | * [[Wikipedia:Clarify the cleanup]] | ||
| + | * [[Wikipedia:Cleanup process]] | ||
| + | * [[Wikipedia:Template messages/Cleanup]] | ||
| + | * ''[[Template:Cleanup template documentation see also section generic list|List of cleanup templates]]'' | ||
| + | |||
| + | == Redirects == | ||
| + | {{Columns-list|colwidth=15em| | ||
| + | * {{Tl|Attention}} | ||
| + | * {{Tl|Attention (on talk page)}} | ||
| + | * {{Tl|Attention see talk}} | ||
| + | * {{Tl|Attn}} | ||
| + | * {{Tl|CU}} | ||
| + | * {{Tl|Clean}} | ||
| + | * {{Tl|Clean up}} | ||
| + | * {{Tl|Clean-up}} | ||
| + | * {{Tl|Cleancat}} | ||
| + | * {{Tl|Cleanup-article}} | ||
| + | * {{Tl|Cleanup-because}} | ||
| + | * {{Tl|Cleanup-date}} | ||
| + | * {{Tl|Cleanup-quality}} | ||
| + | * {{Tl|Cleanup-reason}} | ||
| + | * {{Tl|Cleanup-since}} | ||
| + | * {{Tl|Clu}} | ||
| + | * {{Tl|Cu}} | ||
| + | * {{Tl|Improve}} | ||
| + | * {{Tl|Index-cleanup}} | ||
| + | * {{Tl|Quality}} | ||
| + | * {{Tl|Tidy}} | ||
| + | }} | ||
| + | |||
| + | == Wrappers == | ||
| + | * {{Tl|Cleanup section}} | ||
| + | ** {{Tl|Cleanup-section}} | ||
| + | ** {{Tl|Clean-up section}} | ||
| + | |||
| + | == TemplateData == | ||
| + | {{TemplateData header}} | ||
| + | <templatedata> | ||
| + | { | ||
| + | "params": { | ||
| + | "1": { | ||
| + | "label": "Type", | ||
| + | "description": "Type of page (e.g. article) or section", | ||
| + | "type": "string" | ||
| + | }, | ||
| + | "reason": { | ||
| + | "aliases": [ | ||
| + | "2" | ||
| + | ], | ||
| + | "label": "Reason", | ||
| + | "description": "Reason for requesting cleanup", | ||
| + | "example": "the article is full of incorrect capitalization", | ||
| + | "type": "string", | ||
| + | "required": true | ||
| + | }, | ||
| + | "nocat": { | ||
| + | "type": "string", | ||
| + | "label": "No category", | ||
| + | "description": "Suppress categorization", | ||
| + | "example": "true" | ||
| + | }, | ||
| + | "small": { | ||
| + | "label": "Small", | ||
| + | "description": "Small format", | ||
| + | "example": "left", | ||
| + | "type": "string" | ||
| + | }, | ||
| + | "talk": { | ||
| + | "type": "string", | ||
| + | "aliases": [ | ||
| + | "talksection" | ||
| + | ], | ||
| + | "label": "Talk page section", | ||
| + | "description": "the section of the talk page explaining what needs to be done" | ||
| + | }, | ||
| + | "date": { | ||
| + | "label": "Date", | ||
| + | "description": "Date the template was added to the page", | ||
| + | "example": "January 2018", | ||
| + | "type": "string", | ||
| + | "autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}", | ||
| + | "required": 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": [ | ||
| + | "date", | ||
| + | "reason", | ||
| + | "talk", | ||
| + | "small", | ||
| + | "1", | ||
| + | "nocat" | ||
| + | ], | ||
| + | "format": "inline" | ||
| + | } | ||
| + | </templatedata> | ||
| + | <includeonly>{{sandbox other|| | ||
| + | <!-- CATEGORIES AND INTERWIKIS HERE, THANKS --> | ||
| + | [[Category:Cleanup templates|Cleanup]] | ||
| + | [[Category:Exclude in print|Τ Cleanup]] | ||
| + | [[az:Şablon:Təmizləmə]] | ||
| + | [[Category:Templates_that_are_not_mobile_friendly]] | ||
| + | }}</includeonly> | ||
Revision as of 01:51, 3 June 2019
| This is a documentation subpage for Template:Cleanup. It contains usage information, categories and other content that is not part of the original template page. |
| This template should be substituted only if you want to automatically add the "date=" parameter. |
| This template is used on approximately 13,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
Transclusion count updated automatically (see documentation). |
| If you plan to make breaking changes to this template, move it, or nominate it for deletion, please notify Twinkle's users and maintainers at Wikipedia talk:Twinkle as a courtesy, as this template is used in the standard installation of Twinkle. Thank you! |
| This template uses Lua: |
Contents
Post Articles on 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
{{Cleanup}} should be used with the following two parameters:
|reason=: the reason for requesting cleanup. This is useful for editors in case the reason for requesting a cleanup is not immediately obvious.|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.
Optional parameters include:
- the first parameter: changes the default descriptor (i.e. "Article"). Example tl|Cleanup|section changes it to "Section". A wrapper is {{Cleanup section}}
|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.
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:
This article may require cleanup to meet Wikipedia's quality standards. The specific problem is: the article is full of incorrect capitalization. (December 2025) |
| 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
- {{Cleanup AfD}} – For AfD discussions that closed as "keep", but require cleanup
- {{Cleanup image}} – For images that need cleanup
- {{Cleanup reorganize}} – For articles that need a reorganization in addition to cleanup
- {{Cleanup see also}} – For "See also" sections
- {{Multiple issues}}
- {{Spacing}}
- Wikipedia:Clarify the cleanup
- Wikipedia:Cleanup process
- Wikipedia:Template messages/Cleanup
- List of cleanup templates
Redirects
- {{Attention}}
- {{Attention (on talk page)}}
- {{Attention see talk}}
- {{Attn}}
- {{CU}}
- {{Clean}}
- {{Clean up}}
- {{Clean-up}}
- {{Cleancat}}
- {{Cleanup-article}}
- {{Cleanup-because}}
- {{Cleanup-date}}
- {{Cleanup-quality}}
- {{Cleanup-reason}}
- {{Cleanup-since}}
- {{Clu}}
- {{Cu}}
- {{Improve}}
- {{Index-cleanup}}
- {{Quality}}
- {{Tidy}}
Wrappers
- {{Cleanup section}}
- {{Cleanup-section}}
- {{Clean-up section}}
TemplateData
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.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Date | date | Date the template was added to the page
| String | required |
| Reason | reason 2 | Reason for requesting cleanup
| String | required |
| Talk page section | talk talksection | the section of the talk page explaining what needs to be done | String | optional |
| Small | small | Small format
| String | optional |
| Type | 1 | Type of page (e.g. article) or section | String | optional |
| No category | nocat | Suppress categorization
| String | optional |