View source for Template:Attribution needed/doc

{{Documentation subpage}}
<!-- Categories at the end of this page, please; interwikis links at Wikidata. -->
This is an [[Wikipedia:WikiProject Inline Templates|inline template]] which should be placed immediately after the material in question, as with a footnote. For example:
: <code> This sentence needs attribution.{{tlf|{{BASEPAGENAME}}|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} </code> → This sentence needs attribution.{{{{BASEPAGENAME}}|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

The wikilink on "attribution needed" is set to [[Wikipedia:Attribution needed]]. The functionality of this template is the same as {{tlp|clarify}} but differs in when it is applied.

==When to use==

Use this to request [[WP:INTEXT|in-text attribution]] or an [[Wikipedia:Inline citation|inline citation]] for perspectives and opinions that the Wikipedia article asserts is held by someone, but you don't know who holds the view.

If the material is supported by a citation to a reliable source, then look at the source to find out who holds the view, rather than adding this tag to the sentence.

Do not demand in-text attribution for simple, non-controversial facts.  Simple facts, like "The Earth is round", should not be attributed to one person, because that attribution implies that very few people agree with the statement.  In-text attribution is normally reserved for minority views, controversial claims, and other widely disputed material.

* Controversial, poorly sourced perspectives and opinions in biographies of living persons [[Wikipedia:Biographies of living persons#Remove unsourced or poorly sourced contentious material|should be '''deleted immediately''']], without moving it to the article's talk page.
* If you have reason to think that these perspectives and opinions are not attributable to anyone by a reliable source, you may remove them altogether.  Optionally, paste them into the article's [[Wikipedia:talk page|talk page]] and explain your reasoning of why they should be removed.
* '''If you know whom the perspectives and opinions can be attributed to:'''  Please [[Wikipedia:Be bold|be '''bold''']], delete the template, and indicate whom they are attributed to, either in the text or with a [[Wikipedia:Citing sources|citation]].

Avoid "[[WP:DRIVEBYTAG|drive-by tagging]]" and "[[Wikipedia:Tag bombing|tag bombing]]". It is much more constructive to edit an article to resolve a problem than it is to just leave a tag. Only tag if a resolution to the problem is not apparent.

==Primary application==

Use this template in the body of an article as a request for other editors to explicitly attribute a preceding passage, sentence or phrase to a person. This will be an author of a cited work or a person referred to in a source in which they have been directly or indirectly quoted. The passage tagged may indicate [[Wikipedia:No original research|research]], be opinion, a [[Wikipedia:Describing points of view|point of view]] or contain [[Wikipedia:Manual of Style/Words to watch|words to watch]] which may be appropriate to retain in the article if they are properly attributed. The tag can be resolved by attributing the identified passage, sentence or phrase as either a [[direct quote|direct]] or an [[indirect quote]]. Alternatively, the material may be rewritten in language which is not contentious.

===Examples===

====Example one====

::{{!xt|Opinion text}}
:Resolved as:
::{{xt|Author, ''Name'', stated: "Opinion text".}} (a direct quote)
::{{xt|Author, ''Name'', stated: Opinion text.}} (an indirect quote)

In making an in-text attribution to a person, it is usual (in the first instance) to establish their "[[credential]]s" and why their opinion is of consequence. Identifying them as an author, historian, critic, company president, manager or such, establishes their credentials and, the relevance and credibility of their opinion or other statement.

====Example two====

::{{!xt|It was clearly a matter of ...}} (in this case, ''clearly'' is [[Wikipedia:Manual of Style/Words to watch#Editorializing|editorialising]])
:Resolved as:
::{{xt|According to the author, ''Name'', it was clearly a matter of ...}} (attributing the editorial to a source)
:or
::{{xt|It was a matter of ...}} (removing the word that is editorial)
:Usage of the tag is similar to {{tl|Specify}} but differs, in how the issue might be resolved in these instances.

==Secondary application==

A secondary use of the template is for direct quotations (such as indicated by [[Quotation mark|quote marks]] or a [[Block quotation|block quote]]) which is not immediately followed by an inline [[citation]] to explicitly indicate the source of the quote.

===Examples===

====Example three====

::{{!xt|It was "clearly a case of XYZ." Next sentence[s].{{dummy reference|1}}}}

In writing this, it was the editor's intent to quote from the source cited; however, the citation for a quote should be explicit.

Resolved as:

::{{xt|It was "clearly a case of XYZ."{{dummy reference|1}} Next sentence[s].{{dummy reference|1}}}}

====Example four====

::{{!xt|It was "clearly a case of XYZ." Next sentence[s].{{dummy reference|1}}{{dummy reference|2}}{{dummy reference|3}}{{dummy reference|4}}}}

In this case, the source of the quote is even less clear.

:Resolved as:
::{{xt|It was "clearly a case of XYZ."{{dummy reference|1}} Next sentence[s].{{dummy reference|1}}{{dummy reference|2}}{{dummy reference|3}}{{dummy reference|4}}}}

This example has similarities to the use of {{tl|Specify}}, where two opposing views are expressed but which sources apply is not clear. The distinction in usage is that this template is applied at the point of the quote and is to resolve which source applies to the quote.

====Example five====

::{{!xt|It was "the most something" of a case of XYZ. Next sentence[s].{{dummy reference|1}}}}

This is an example of where the article editor appears to be quoting a phrase from a source, as opposed from using quote marks for [[use–mention distinction]] or a [[Scare quotes|scare quote]].  The citation should be bought closer to the quote.

:Resolved as:
::{{xt|It was "the most something" of a case of XYZ.{{dummy reference|1}} Next sentence[s].{{dummy reference|1}}}}

This is appropriate where the quoted phrase is not reasonably mistaken as [[use–mention distinction]] or a [[Scare quotes|scare quote]].

:or
::{{xt|It was "the most something"{{dummy reference|1}} of a case of XYZ. Next sentence[s].{{dummy reference|1}}}}

Where the quoted phrase might be mistaken as [[use–mention distinction]] or a [[Scare quotes|scare quote]].  

:An alternative is to explicitly attribute the phase quoted.
::{{xt|It has been described by the author, ''Name'', as "the most something" of a case of XYZ.{{dummy reference|1}} Next sentence[s].{{dummy reference|1}}}}
:or
::{{xt|It has been described by the author, ''Name'', as "the most something"{{dummy reference|1}} of a case of XYZ. Next sentence[s].{{dummy reference|1}}}}

Scare quotes should, in general, be be attributed, since they usually represent a "point of view", unless they are the subject of discussion.

::{{!xt|It was "scare quote" ...}}
:as opposed to
::{{xt|The "scare quote" was the subject of ...}}

===Exceptions===

If a quoted phrase is the subject of discussion, once its "[[provenance]]" has been established by an initial citation, it is not necessary to require further citations at each subsequent mention.

Where a citation at the end of a sentence refers to a quoted phrase, the proximity of a quoted phrase to the citation is of significance. The more words between the quoted phase and the citation, the less clear it is that the quote is drawn from the citation.

====Example six====

::{{xt|It was "quote phrase".{{dummy reference|1}}}} (clear)
::{{xtd|It was "quote phrase" that did this.{{dummy reference|1}}}} (reasonably clear)
::{{!xt|It was "quote phrase" that did this, that and the other thing and something else.{{dummy reference|1}}}} (unclear)
:Resolved as:
::{{xt|It was "quote phrase"{{dummy reference|1}} that did this, that and the other thing and something else - not to mention a few other things.{{dummy reference|1}}}}

In the resolved case, it is clear that the quoted phrase is supported by a citation and not an editorial use of quote marks.

== Relation to other tag templates ==

When the problem is not one resolved by making the attribution clear one may use {{tl|specify}} instead. For dealing with dubious information, please use one of the following: {{tl|citation needed}}, {{tl|verify source}}, {{tl|dubious}} or {{tl|disputed-inline}}. This if the problem is a reference to vague "authorities" such as "serious scholars", "historians say", "some researchers", "many scientists", and the like, use {{tl|who}}.  If the problem is with test that is difficult to understand, use {{tl|clarify}}.

This [[Wikipedia:Template|template]] is a [[Wikipedia:Avoid self-references|self-reference]] and so is part of the Wikipedia project rather than the encyclopedic content.

== Parameters ==
Abbreviated parameter sets: 
* {{tlc|{{BASEPAGENAME}}|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|3=reason=}}
* {{tlc|{{BASEPAGENAME}}|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|3=reason=|4=text=}}

Full parameter set: 
* {{tlc|{{BASEPAGENAME}}|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|3=reason=|4=text=|5=pre-text=|6=post-text=}}

Parameter descriptions
* {{para|date}} : This template allows an optional date parameter that records when the tag was added. If this template is added without the date parameter, the date parameter will be added soon after by a [[WP:BOT|bot]]. Alternatively, you may add the date automatically (without requiring bot intervention) by [[WP:SUBST|substituting]] the template. That is: {{tlsc|{{BASEPAGENAME}}}} is equivalent to {{tlc|{{BASEPAGENAME}}|2=date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}. This technique also works if other parameters – {{para|reason}} {{para|pre-text}} {{para|post-text}} – are given.
* {{para|reason}} : Because it may not be immediately apparent to other editors what about the tagged passage is in need of attribution, it is generally helpful to add a brief reason for the tag: {{tlc|{{BASEPAGENAME}}|reason{{=}}<var>What the problem is</var>}} (this is preferable to using an HTML <code>&lt;!-- comment --&gt;</code> after the tag, as it is tidier to keep all of the {{Tlc|{{BASEPAGENAME}}}}-related code inside the template). If the explanation would be lengthy, use the article's talk page{{parabr}}As well as being visible in the source code for editors' benefit, {{para|reason}}, if provided, displayed when the mouse is hovered over the "attribution needed" link in the article. For technical reasons, this mouse-over feature does not work if the reason text contains double quotes. Use single quotes instead, or use the code <code>&amp;quot;</code> if it is essential to include a double quote.
* {{para|text}}: The particular text needing attribution may be highlighted by wrapping this template around it:
*: As an example:
*:: ''Text preceding the template'',{{tlc|{{BASEPAGENAME}}|text{{=}}unattributed text,|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}, ''text following the template''. 
*: produces: 
*: ''Text preceding the template'',{{{{BASEPAGENAME}}|text=unattributed text,|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}, ''text following the template''.
* {{para|pre-text}}
* {{para|post-text}}: One can specify additional text to appear before and/or after the "attribute" tag using the two parameters listed above.

Examples:
# {{tlc|{{BASEPAGENAME}}|pre-text{{=}}remove or}}
#:will cause the text "remove or" to appear before "attribute" like this:{{{{BASEPAGENAME}}|pre-text=remove or}}
# {{tlc|{{BASEPAGENAME}}|post-text{{=}}(unattributed opinion)}}
#:will cause "(unattributed opinion)" to appear after "attribute" like this:{{{{BASEPAGENAME}}|post-text=(unattributed opinion)}}.
# {{tlc|{{BASEPAGENAME}}|post-text{{=}}(see [[Talk:Example#Attribution needed|talk]])}}
#:can be used to link to a discussion on the article's talk page; this example produces:{{{{BASEPAGENAME}}|post-text=(see [[Talk:Example#Attribution needed|talk]])}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "Use this inline template as a request for other editors to attribute text that may research, opinion, a point of view, contain ''words to watch'' or is a quote that has not been clearly attributed. Place immediately after the material in question.",
	"params": {
		"reason": {
			"label": "reason",
			"type": "string",
			"description": "A brief reason for the tag; do not include any double quotes.",
			"suggested": true
		},
		"text": {
			"label": "text",
			"type": "string",
			"description": "Text fragment containing concerns the tag is supposed to address."
		},
		"date": {
			"label": "date",
			"type": "string",
			"description": "The date the tag was added (this will be added automatically soon by a bot if not added manually).",
			"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
			"required": true
		},
		"pre-text": {
			"label": "pre-text",
			"type": "string",
			"description": "Any string to be added before the \"Attribute\" tag, such as \"?\""
		},
		"post-text": {
			"label": "post-text",
			"type": "string",
			"description": "Any string to be added after the \"Attribute\" tag, such as \"unattributed opinion\"."
		}
	}
}
</templatedata>

== Categorization ==
Adding this template to an article will automatically place the article into [[:Category:Wikipedia articles needing words, phrases or quotes attributed]], or a dated subcategory thereof.

== Redirects ==

* {{tl|Attribute}}

== See also ==

* {{Tl|Cite check}} &ndash; message-box
* {{Tl|Cite quote}} &ndash; message-box
* {{tl|POV check inline}} &ndash; message-box
* {{Tl|Weasel}} &ndash; message-box
* {{tl|Peacock term}} &ndash; message-box
* {{Tl|Opinion}} &ndash; message-box
* {{Tl|Specify}} &ndash; message-box
* {{Tl|Who}} &ndash; message-box
* [[Wikipedia:Attribution needed]]
* [[Wikipedia:Manual of Style/Words to watch#Unsupported attributions]]
* [[Wikipedia:Template messages/Cleanup/Verifiability and sources]]
* [[Wikipedia:Citing sources]]

{{Inline tags}}

<includeonly>{{sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Inline citation and verifiability dispute templates]]
[[Category:Inline citation cleanup templates]]
[[Category:Inline cleanup templates]]
}}</includeonly>