View source for Template:Refexample/doc

{{Documentation subpage}}
{{Tsh|Refex|Refimprove example}}

'''Example template usage for copy-pasting''':

{{tlc|Refexample|section|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

{{tlc|refex|section|small{{=}}y|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

{{tlc|refex|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

{{tlc|Refimprove example|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|talk{{=}}{{var|Talk page section}}}}

__TOC__
{{anchor|Self-sourcing example}}{{anchor|self sourcing example}}{{anchor|self sourcing examples}}{{anchor|self-sourcing}}{{anchor|self sourcing}}{{anchor|Self-sourcing}}{{anchor|Self sourcing}}

==Self-sourcing examples==
===Examples should be ''meaningful'' in the context of the article, explained in the prose and cited to reliable sources===
A [[Wikipedia talk:Verifiability/Archive 63#RfC: Are .22in popular culture.22 entries .22self-sourcing.22 or do they require a reference under Wikipedia:Verifiability and Wikipedia:Identifying reliable sources.3F|self-sourcing example]] in popular culture, according to current consensus by discussion on [[Wikipedia talk:Verifiability|WT:V]], is an example that is cited to [[Wikipedia:No original research#Primary.2C secondary and tertiary sources|primary sources]], or an example with citations that only establish the [[Wikipedia:Verifiability|verifiability]] of the example. An example in popular culture should have sources that not only establish its verifiability, but also discuss its significance in the context of the article.

===Examples of self-sourcing examples===
A self-sourcing example might look like the following:
{{divbox|1=white|3=
[[Jiminy Cricket]] is an example of [[arthropods in film]].<sup>[[#Fakeref1|[1]]][[#Fakeref2|[2]]]</sup>{{Better source example}}
<!-- Fake reference -->
::'''References'''
:{{anchor|Fakeref1}}1. {{cite AV media|title=[[Pinocchio (1940 film)|Pinocchio]]|author=Walt Disney|author-link=Walt Disney|date=1940}}
:{{anchor|Fakeref2}}2. {{cite news |last=Nugent |first=Frank S. |url=https://www.nytimes.com/movie/review?_r=1&res=9A03E2D8113EE33ABC4053DFB466838B659EDE&oref=slogin |title=Pinocchio - The Screen in Review|newspaper=The New York Times |date=February 8, 1940}}
}}
The provided sources establish the [[Wikipedia:Verifiability|verifiability]] of the example. They might even establish its [[Wikipedia:Notability|notability]]. However, they do not discuss the example in the context it's given in the article. Such an example may be challenged or removed.

A source that ''does'' discuss the significance of an example in the context of the article might look like the following:
{{divbox|1=white|3=
[[Jiminy Cricket]] is an example of [[arthropods in film]].<sup>[[#Fakeref3|[1]]]</sup>
<!-- Fake reference -->
::'''References'''
:{{anchor|Fakeref3}}1.{{citation|title=Encyclopedia of Insects|chapter=Insects in Movies|author1=Vincent H. Resh|author2=Ring T. Cardé|publisher=Academic Press|date=2009|isbn=9780080920900|pp=[http://what-when-how.com/insects/movies-insects-in-insects/ 668–674]|quote={{small|Arguably the most well-known animated arthropod was Jiminy Cricket, who initially appeared in a supporting role in the 1940 Walt Disney feature Pinocchio. Disney animators used a talking cricket, a minor character that appeared in the original Pinocchio story by Carlo Collodi, to unify disparate elements within the film. The character proved to be popular as a “voice of conscience” and appeared in several series of subsequent short subjects and educational films. Jiminy exemplifies the liberties taken with insect morphology by animators; although early sketches depicted the character with more insect-like features, the final film version, with its two arms and two legs, eyes with pupils, and morning coat and vest, resembles a dapper elf more than any arthropod.}} }}
}}
The source discusses the example, in the context of the article, at relative depth, while explaining the example's significance in that context.

A source that discusses an example as significant in one context does not necessarily show its significance in another context: 
{{divbox|1=white|3=
[[Jiminy Cricket]] is an example of [[insects in literature]].<sup>[[#Fakeref4|[1]]]</sup>{{better source example}}
<!-- Fake reference -->
::'''References'''
:{{anchor|Fakeref4}}1.{{citation|title=Encyclopedia of Insects|chapter=Insects in Movies|author1=Vincent H. Resh|author2=Ring T. Cardé|publisher=Academic Press|date=2009|isbn=9780080920900|pp=668–674}}
}}
The source discusses the example ''in a different context'' than the one provided.

Some examples may be of [[Template:importance example|questionable importance]].
{{divbox|1=white|3=[[Jiminy Cricket]] is an example of [[insects in literature]].{{citation needed}}{{importance example}} }}

==Usage==

===When to use===
This [[Wikipedia:Templates|template]] indicates that the article or section needs additional inline citations that do not fall under [[Wikipedia talk:Verifiability/Archive 63#RfC: Are .22in popular culture.22 entries .22self-sourcing.22 or do they require a reference under Wikipedia:Verifiability and Wikipedia:Identifying reliable sources.3F|self-sourcing examples]]. This template should be used only for articles where there are insufficient inline citations to support the material currently in the article.

===Inline alternatives===
Please consider marking individual poorly-referenced statements with {{tlx|Better source needed example}} or {{tlx|importance example}} instead of placing this template.

===How to use===
According to [[MOS:LAYOUT]], maintenance templates such as this one ought be placed after hatnotes, at the start of the article. That placement is supported by consensus obtained in an RfC at {{section link|Template talk:More citations needed|RfC: Location of Tag}}.

The optional {{para|talk}} parameter is allowed; setting this to any non-empty value will result in the message "See talk page for details." being included in the tag. If the value is a valid anchor on the talk page (''e.g.'', the title of a section or subsection heading), then the talk page link will go directly to that anchor; if not, to the top of the page.

The optional {{para|small}} parameter is allowed; setting this to any non-empty value will result in a smaller, left-aligned message box.

The optional {{para|date}} parameter is allowed; it requires using a non-abbreviated month name and four-digit year. Adding this parameter sorts the article into subcategories of [[:Category:Articles needing additional references]] and out of the parent category, allowing the oldest problems to be identified and dealt with first. A [[Wikipedia:Bot policy|bot]] will add this parameter if it is omitted. This parameter adds the article to [[:Category:Articles needing additional references from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]], and [[:Category:All articles needing additional references]], both [[:Category:Hidden categories|hidden categories]]. The simplest way to use this parameter manually is to copy the following example:

{{Tlc|Refexample|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

A user warning template, {{tl|Uw-refexample}}, is available to notify contributors that an article they created needs its referencing improved.

==Template data==
{{TemplateData header}}
<templatedata>
{
	"description": "This template generates a tag to indicate that the article needs additional inline citations that do not fall under \"self-sourcing examples\".",
	"params": {
		"1": {
			"label": "Type (typically section)",
			"description": "Something to replace \"article\" in the template, typically \"section\"",
			"type": "string",
			"required": false
		},
		"date": {
			"label": "Date",
			"description": "The month and year that the need for citations is identified, such as 'June 2013'; may use '{{subst:DATE}}' template instead",
			"type": "string",
			"required": false,
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"suggested": true
		},
		"talk": {
			"label": "Talk",
			"description": "Any value (such as 'y') will result in the addition of 'See talk page for details.' to the tag",
			"type": "string",
			"required": false
		},
		"small": {
			"label": "small",
			"description": "Any value (such as 'y') will result in a smaller message box",
			"type": "string",
			"required": false
		}	},
	"format": "block"
}
</templatedata>

==See also==
* [[WP:INDISCRIMINATE]]
* [[Wikipedia talk:Verifiability/Archive 63#RfC: Are .22in popular culture.22 entries .22self-sourcing.22 or do they require a reference under Wikipedia:Verifiability and Wikipedia:Identifying reliable sources.3F|Discussion and consensus about the verifiability of examples]]
* [[:Template:Citation needed/doc#Inline templates]]
** {{Tl|Importance example}} — an inline variation of this template
** {{Tl|Better source}}
** {{Tl|Refimprove inline}}
* {{Tl|Example farm}}
* [[Wikipedia:Template messages/Cleanup/Verifiability and sources]]

{{Citation and verifiability article maintenance templates}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Citation and verifiability maintenance templates]]
}}</includeonly>