BattleIntelligence:Template index/Cleanup: Difference between revisions
imported>Deadfire m Deadfire moved page Draft:Template index/Cleanup to BattleTechWiki:Template index/Cleanup without leaving a redirect: Moving to the correct namespace for this |
Tungstenchan (talk | contribs) m Text replacement - "BattleTechWiki" to "BattleIntelligence" |
||
| Line 3: | Line 3: | ||
{{For|general help on tagging pages|Information:Tagging pages for problems}} | {{For|general help on tagging pages|Information:Tagging pages for problems}} | ||
'''Template messages''' ('''maintenance tags''', '''cleanup tags''', '''cleanup messages''') may be added to articles needing [[ | '''Template messages''' ('''maintenance tags''', '''cleanup tags''', '''cleanup messages''') may be added to articles needing [[BattleIntelligence:Cleanup|cleanup]]. Their purposes are to foster improvement of the encyclopedia by alerting editors to changes that need to be made. Cleanup tags are meant to be temporary notices that lead to an effort to fix the problem, not a permanent ''badge of shame'' to show that you disagree with an article, or a method of warning readers about an article. | ||
Unless otherwise noted, cleanup messages should be placed at the top of the page, before other templates, images, or infoboxes, but after hatnotes (see {{Section link| | Unless otherwise noted, cleanup messages should be placed at the top of the page, before other templates, images, or infoboxes, but after hatnotes (see {{Section link|BattleIntelligence:Hatnote|Placement}}). Cleanup messages should be placed directly on the article or file, not on its talk page. Certain tags can be placed at the beginning of an individual section, and others can be placed within the text itself (inline). | ||
Before you tag an article, please remember the following: | Before you tag an article, please remember the following: | ||
| Line 25: | Line 25: | ||
==Best practices== | ==Best practices== | ||
===Does the page need it?=== | ===Does the page need it?=== | ||
Before placing templates on a page it is worthwhile to cast a [[w:Critical thinking|critical]] eye over the page to determine whether indeed it should be included in | Before placing templates on a page it is worthwhile to cast a [[w:Critical thinking|critical]] eye over the page to determine whether indeed it should be included in BattleIntelligence. If you find that the article should be tagged or nominated for deletion, [[Help:Deletion|please see this guideline in doing so]]. | ||
===Obscure or unpopular articles=== | ===Obscure or unpopular articles=== | ||
| Line 31: | Line 31: | ||
===Heavily monitored articles=== | ===Heavily monitored articles=== | ||
On pages that are being edited by a number of users, cleanup templates are used to inform readers and editors of ongoing discussions and attempts to fix the problems on the page. Such templates can be used to attract uninvolved users to discussions and cleanup efforts, and they can also serve as a warning to casual readers that the article may have problems and be subject to noticeable changes. In general, an editor who places a template message to indicate a problem like this should explain their rationale fully on the [[Help:Talk pages|talk page]] of the article. If the [[ | On pages that are being edited by a number of users, cleanup templates are used to inform readers and editors of ongoing discussions and attempts to fix the problems on the page. Such templates can be used to attract uninvolved users to discussions and cleanup efforts, and they can also serve as a warning to casual readers that the article may have problems and be subject to noticeable changes. In general, an editor who places a template message to indicate a problem like this should explain their rationale fully on the [[Help:Talk pages|talk page]] of the article. If the [[BattleIntelligence:Consensus|consensus]] of the other editors is that there is a problem or an editorial dispute that deserves such a clean-up template, then the editors should work to fix the problem as quickly and cleanly as possible so the template message can be removed. If the consensus is that there is no problem, then the message can be removed immediately. For heavily monitored articles, please do not add or remove template messages of this sort without using the talk page. | ||
===Use in sections=== | ===Use in sections=== | ||
| Line 120: | Line 120: | ||
===Fiction=== | ===Fiction=== | ||
{{See also| | {{See also|BattleIntelligence:Manual of Style/Writing about fiction}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 133: | Line 133: | ||
===Style of writing=== | ===Style of writing=== | ||
{{see also| | {{see also|BattleIntelligence:Five pillars|Policy:What BattleIntelligence is not|BattleIntelligence:Words to watch}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 147: | Line 147: | ||
===Structure, formatting and sections=== | ===Structure, formatting and sections=== | ||
{{See also|Help:Section| | {{See also|Help:Section|BattleIntelligence:Manual of Style/Headings|BattleIntelligence:Manual of Style/Layout}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 160: | Line 160: | ||
====Introduction==== | ====Introduction==== | ||
{{See also| | {{See also|BattleIntelligence:Manual of Style/Lead section}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 173: | Line 173: | ||
===Potentially unwanted content=== | ===Potentially unwanted content=== | ||
{{see also|Policy:What | {{see also|Policy:What BattleIntelligence is not}} | ||
====Message boxes==== | ====Message boxes==== | ||
| Line 217: | Line 217: | ||
{{tlrow|expand section|category=Articles to be expanded}} | {{tlrow|expand section|category=Articles to be expanded}} | ||
* When calling this template, you may pass it a parameter. A template call like {{tlx |expand section | examples and additional citations}} generates: "This section requires expansion with: examples and additional citations." | * When calling this template, you may pass it a parameter. A template call like {{tlx |expand section | examples and additional citations}} generates: "This section requires expansion with: examples and additional citations." | ||
{{tlrow|lacking overview|category= | {{tlrow|lacking overview|category=BattleIntelligence articles needing context}} | ||
{{tlrow|missing information|category=Articles to be expanded}} | {{tlrow|missing information|category=Articles to be expanded}} | ||
* When calling this template, you must pass it a parameter. A template call like {{tlx |Missing information | why bananas are yellow}} generates "This article is missing information about why bananas are yellow." | * When calling this template, you must pass it a parameter. A template call like {{tlx |Missing information | why bananas are yellow}} generates "This article is missing information about why bananas are yellow." | ||
| Line 223: | Line 223: | ||
===Time-sensitive=== | ===Time-sensitive=== | ||
{{See also| | {{See also|BattleIntelligence:Manual of Style/Dates and numbers|Category:Temporal templates}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 299: | Line 299: | ||
!Tag | !Tag | ||
!width=100%|Text that will be shown (and usage notes) | !width=100%|Text that will be shown (and usage notes) | ||
{{tlrow|bad summary|category= | {{tlrow|bad summary|category=BattleIntelligence articles with content forks}} | ||
{{tlrow|duplication|category=Articles in need of internal merging}} | {{tlrow|duplication|category=Articles in need of internal merging}} | ||
|} | |} | ||
===Importance and notability=== | ===Importance and notability=== | ||
{{See also2|[[Policy:What | {{See also2|[[Policy:What BattleIntelligence is not]] (importance conveyed by sources) and [[Policy:Notability]] (coverage by sources).}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 346: | Line 346: | ||
{{tlrow|editorializing|category=Articles with minor POV problems}} | {{tlrow|editorializing|category=Articles with minor POV problems}} | ||
{{tlrow|excessive citations inline|category=Citation overkill}} | {{tlrow|excessive citations inline|category=Citation overkill}} | ||
* For abuse of citations, per [[ | * For abuse of citations, per [[BattleIntelligence:Citing sources]]. | ||
{{tlrow|POV statement|category=Articles with POV problems}} | {{tlrow|POV statement|category=Articles with POV problems}} | ||
{{tlrow|undue weight inline|category=Articles with POV problems}} | {{tlrow|undue weight inline|category=Articles with POV problems}} | ||
| Line 374: | Line 374: | ||
===Lists=== | ===Lists=== | ||
{{see also| | {{see also|BattleIntelligence:Manual of Style/Lists}} | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 397: | Line 397: | ||
===Wiki tech=== | ===Wiki tech=== | ||
Most of these issues are covered in the main [[ | Most of these issues are covered in the main [[BattleIntelligence:Manual of Style|Manual of Style]]. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 406: | Line 406: | ||
* Use this to mark articles or sections that completely lack internal links. | * Use this to mark articles or sections that completely lack internal links. | ||
{{Replace|{{tlrow|disambiguation cleanup|category=Disambiguation pages in need of cleanup}}|__DISAMBIG__|}} | {{Replace|{{tlrow|disambiguation cleanup|category=Disambiguation pages in need of cleanup}}|__DISAMBIG__|}} | ||
* Use this for disambiguation pages not written according to the style in [[ | * Use this for disambiguation pages not written according to the style in [[BattleIntelligence:Manual of Style/Disambiguation]]. | ||
* Replace {{tl|disambiguation}} with this. | * Replace {{tl|disambiguation}} with this. | ||
{{tlrow|orphan|category=Orphaned articles}} | {{tlrow|orphan|category=Orphaned articles}} | ||
| Line 439: | Line 439: | ||
==Other article tags== | ==Other article tags== | ||
There are also tags available for: | There are also tags available for: | ||
* [[ | * [[BattleIntelligence:Template index/Merging|'''merging''']] articles; | ||
* [[ | * [[BattleIntelligence:Template index/Moving|'''moving''']] articles; | ||
* [[ | * [[BattleIntelligence:Template index/Splitting|'''splitting''']] articles; | ||
==See also== | ==See also== | ||
| Line 449: | Line 449: | ||
<noinclude> | <noinclude> | ||
{{Inline cleanup tags|state=uncollapsed}} | {{Inline cleanup tags|state=uncollapsed}} | ||
{{ | {{BattleIntelligence templates}} | ||
[[Category:WikiProject Cleanup|*]] | [[Category:WikiProject Cleanup|*]] | ||
[[Category:Template administration]] | [[Category:Template administration]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 00:14, 1 May 2025
This is an information page. It is not one of BattleIntelligence's policies or guidelines, but rather intends to describe some aspect(s) of BattleIntelligence's norms, customs, technicalities, or practices. It may reflect varying levels of consensus and vetting. |
| This page in a nutshell: Add template messages to inform readers and editors of specific problems with articles or sections, but do not use them as a badge of shame. |
Template messages (maintenance tags, cleanup tags, cleanup messages) may be added to articles needing cleanup. Their purposes are to foster improvement of the encyclopedia by alerting editors to changes that need to be made. Cleanup tags are meant to be temporary notices that lead to an effort to fix the problem, not a permanent badge of shame to show that you disagree with an article, or a method of warning readers about an article.
Unless otherwise noted, cleanup messages should be placed at the top of the page, before other templates, images, or infoboxes, but after hatnotes (see BattleIntelligence:Hatnote § Placement). Cleanup messages should be placed directly on the article or file, not on its talk page. Certain tags can be placed at the beginning of an individual section, and others can be placed within the text itself (inline).
Before you tag an article, please remember the following:
- Don't tag an article if you can easily and confidently fix the problem.
- The goal is an improved article, not a tagged article.
- Do some research to attempt to solve the problem before tagging.
- Don't put the burden of doing so on another editor if you are capable of fixing the problem yourself with a simple search or consulting a reference work.
- Don't do "drive-by" tagging.
- Tags must be accompanied by either a comment on the article's talk page explaining the problem and beginning a discussion on how to fix it or, for simpler and more obvious problems, a remark using the reason parameter (available in all templates, regardless of whether it appears in the documentation) as shown below. At the very least, tagging editors must be willing to follow through with substantive discussion.
- Don't do "drive-by" de-tagging.
- Likewise, please provide a similar rationale for removing a template, unless your preceding edits have clearly fixed the announced problem. See also when not to remove a template.
- Don't insert tags that are similar or redundant.
- For example, most articles that read like essays have an inappropriate tone, and in fact they end up being automatically grouped in the same category, so it is unnecessary to tag with both {{tone}} and {{copy-edit}}.
- If an article has many problems, tag only the highest priority issues.
- A lengthy list is often less helpful than a shorter one.
- Don't add tags for trivial or minor problems, especially if an article needs a lot of work.
- For example, there is little point in noting grammatical problems for a section that needs to be completely re-written to comply with content policies. Focus on the biggest one, two, or three problems.
Best practices
Does the page need it?
Before placing templates on a page it is worthwhile to cast a critical eye over the page to determine whether indeed it should be included in BattleIntelligence. If you find that the article should be tagged or nominated for deletion, please see this guideline in doing so.
Obscure or unpopular articles
On pages that have received little attention from editors or readers, cleanup templates can be used as a way to call attention to problems that need to be addressed by editors. Editors who want to help address these problems should look through the various cleanup categories such as maintenance and articles with content issues and try to address the problems so that the templates can be removed.
Heavily monitored articles
On pages that are being edited by a number of users, cleanup templates are used to inform readers and editors of ongoing discussions and attempts to fix the problems on the page. Such templates can be used to attract uninvolved users to discussions and cleanup efforts, and they can also serve as a warning to casual readers that the article may have problems and be subject to noticeable changes. In general, an editor who places a template message to indicate a problem like this should explain their rationale fully on the talk page of the article. If the consensus of the other editors is that there is a problem or an editorial dispute that deserves such a clean-up template, then the editors should work to fix the problem as quickly and cleanly as possible so the template message can be removed. If the consensus is that there is no problem, then the message can be removed immediately. For heavily monitored articles, please do not add or remove template messages of this sort without using the talk page.
Use in sections
Many of these cleanup tags require you to place |article as the first parameter when you use the tag at the top of an article. When you want the template to refer to just one section, however, you replace |article with |section (where the | is a pipe key | found on most keyboards as a shift-backslash ⇧ Shift+\. See the specific template below to determine if such "section use" is supported and appropriate.
Tag consolidation
If too many tags are put at the top of an article, the article can become eclipsed by the tags, especially with short or stub articles. Consider consolidating the tags into {{multiple issues}}.
Cleanup
Overarching copyright issues
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{copypaste}} category |
|
Combined message boxes
Do not use this as the only message box on the article or section; it should be used with at least two other message boxes sandwiched inside it.
| Tag | Text that will be shown (and usage notes) — multiple issues (top of article) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| {{multiple issues}}
|
|
| Tag | Text that will be shown (and usage notes) — multiple issues (section) | ||||||||
| {{multiple issues|section=yes}}
|
|
General cleanup
Use one of these general tags when none of the more specific tags fits.
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{cleanup}} category |
| ||
| {{cleanup rewrite}} category |
| ||
| {{section rewrite}} category |
| ||
| {{cleanup section}} category |
|
Copy editing
Some articles just need someone with a good grasp of editing technique to give them a once-over.
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{copy edit}} category |
| ||
| {{copy edit section}} category |
| ||
| {{verify spelling}} category |
[spelling?] |
Inline with article text
| Tag | Text that will be shown (and usage notes) |
|---|---|
| {{Copy edit inline}} category |
[needs copy edit]
|
Fiction
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{all plot}} category |
| ||
| {{long plot}} category |
| ||
| {{more plot}} category |
| ||
| {{no plot}} category |
|
Style of writing
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{abbreviations}} category |
| ||
| {{repetition}} category |
| ||
| {{story}} category |
| ||
| {{tone}} category |
| ||
| {{verbosity}} category |
|
Structure, formatting and sections
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{copy edit}} category |
| ||
| {{duplication}} category |
| ||
| {{sections}} category |
| ||
| {{very long}} category |
|
Introduction
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{lead missing}} category |
| ||
| {{lead rewrite}} category |
| ||
| {{lead too long}} category |
| ||
| {{lead too short}} category |
|
Potentially unwanted content
Message boxes
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{AI-generated}} category |
Template:AI-generated | ||
| {{cleanup list}} category |
| ||
| {{cleanup red links}} category |
Template:Cleanup red links | ||
| {{copypaste}} category |
| ||
| {{criticism section}} category |
| ||
| {{external links}} category |
| ||
| {{MOS}} category |
|
Context, statistics and detail
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{context}} category |
| ||
| {{overly detailed}} category |
|
Off-topic
Articles occasionally contain content which is otherwise valid, but appears unrelated to the nominal topic of the article.
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{off topic}} category |
|
Expand and add
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{expand section}} category |
| ||
| {{lacking overview}} category |
| ||
| {{missing information}} category |
|
Time-sensitive
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
{{update needed|Example}}
|
{{#set:Update Needed From=Example}} | ||
| {{update}} category |
| ||
{{update|inaccurate=y}}category |
|
Inline with article text
| Tag | Text that will be shown (and usage notes) |
|---|---|
| {{clarify timeframe}} category |
[timeframe?]
|
| {{update after}} category |
[needs update]
|
| {{update inline}} category |
[needs update]
|
| {{as of}} category |
As of {{{1}}}[update]
|
Major edits
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{under construction}} category |
| ||
| {{under development}} category |
| ||
| {{in use}} category |
| ||
| {{in creation}} category |
|
Contradiction and confusion
- Note: Templates relevant for when articles are confusing or hard to understand.
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{confusing}} category |
| ||
| {{contradicts other}} category |
Template:Contradicts other | ||
| {{contradicts others}} category |
Template:Contradicts others
| ||
| {{incomprehensible}} category |
| ||
| {{misleading}} category |
Template:Misleading
| ||
| {{self-contradictory}} category |
Template:Self-contradictory | ||
| {{unfocused}} category |
Template:Unfocused
|
Inline with article text
| Tag | Text that will be shown (and usage notes) |
|---|---|
| {{contradict-inline}} category |
[contradictory]
|
| {{expand acronym}} |
[expand acronym]
|
| {{inconsistent}} category |
[inconsistent]
|
| {{vague}} category |
[vague]
|
Content forks
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{bad summary}} category |
| ||
| {{duplication}} category |
|
Importance and notability
| Tag | Text that will be shown (and usage notes) |
|---|---|
| {{importance inline}} |
[importance?]
|
| {{importance section}} |
Template:Importance section |
| {{notability}} category |
Template:Notability
|
Neutrality and factual accuracy
Message boxes
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{COI}} category |
| ||
| {{disputed}} category |
| ||
| {{disputed section}} category |
| ||
| {{POV}} category |
| ||
| {{POV lead}} category |
|||
| {{POV section}} category |
| ||
| {{undue weight}} category |
Template:Undue weight |
Inline with superimposed text
| Tag | Text that will be shown (and usage notes) |
|---|---|
| {{according to whom}} category |
[according to whom?]
|
| {{clarify}} category |
[clarification needed]
|
| {{dubious}} category |
[dubious ] |
| {{editorializing}} category |
[editorializing] |
| {{excessive citations inline}} category |
[excessive citations]
|
| {{POV statement}} category |
[neutrality is disputed] |
| {{undue weight inline}} category |
[undue weight? – discuss] |
| {{when}} category |
[when?]
|
| {{who}} category |
[who?]
|
Verifiability and sources
Categories
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{improve categories}} category |
| ||
| {{recategorize}} category |
| ||
| {{uncategorized}} category |
|
Lists
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{cleanup list}} category |
| ||
| {{create list}} category |
| ||
| {{disputed list}} category |
| ||
| {{list scope}} category |
| ||
| {{list to table}} category |
| ||
| {{Unsorted list}} category |
| ||
| {{prose}} category |
|
Wiki tech
Most of these issues are covered in the main Manual of Style.
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{dead end}} category |
| ||
| {{disambiguation cleanup}} category |
| ||
| {{orphan}} category |
| ||
| {{uncategorized}} category |
| ||
| {{underlinked}} category |
|
Infobox needed
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{infobox requested}} category |
| ||
| {{new infobox}} category |
|
Infobox cleanup needed
| Tag | Text that will be shown (and usage notes) | ||
|---|---|---|---|
| {{cleanup infobox}} category |
|
Other article tags
There are also tags available for:
See also
- This essay on Wikipedia essay about responsible tagging includes advice on what sorts of things one can say on to help others see that every tag makes sense for the article.
- Information:Tagging pages for problems