Template:Cleanup/doc

From CAPipedia

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

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.

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

Alternatives

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.

If you feel that an article needs a significant amount of cleanup, you can post it to WikiProject Cleanup. It is more effective than using {{Cleanup}} as there is a backlog for the tags. Editors will give your submitted article a cleanup and fix any problems associated with it.

How to use

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

  • |date=: the month and year (e.g. November 2024) 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. This parameter's value is not used when {{Cleanup}} appears inside {{Multiple issues}}.
  • |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.

Examples

For example, {{Cleanup|reason=The article is full of incorrect capitalization.|date=November 2024}} would display as:

(although {{copyedit}} would be the more appropriate tag to use in that specific case)

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}}.

TemplateData

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

TemplateData for Cleanup

<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": { "date": { "label": "Month and year", "description": "The month and year that the template was placed (in full). \"{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}\" inserts the current month and year automatically.", "type": "line", "autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}", "example": "January 2013", "suggested": true }, "reason": { "label": "Reason", "description": "Reason for requesting cleanup", "type": "string", "example": "The article is full of incorrect capitalization.", "required": true }, "talk": { "aliases": [ "talksection" ], "label": "Talk page section", "description": "The section of the talk page explaining what needs to be done", "type": "string" }, "small": { "label": "Make template small", "description": "Enter \"left\" here to make the template box small and aligned to the left.", "type": "line", "autovalue": "left", "example": "left" }, "1": { "label": "Affected area", "description": "Text to replace the word \"article\", usually \"section\"", "type": "line", "autovalue": "section", "example": "section" }, "nocat": { "label": "No category", "description": "Suppress categorization", "type": "string", "autovalue": "true", "example": "true" } }, "paramOrder": [ "date", "reason", "talk", "small", "1", "nocat" ] } </templatedata>

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