Editing Template:Requested move/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Redirect2|Template:Move|Template:Move-multi|the template for moving discussions|Template:Moved discussion to|details on the corresponding procedure|#Multiple related move requests}}
{{Redirect-confused|Template:Rename|Template:Renamed}}
{{Template shortcut|pre=subst:|Move|Rename|Rm}}
{{Subst only}}
{{Twinkle standard installation}}
{{Bot use warning|bots=[[User:RMCD bot]]}}
{{Lua|Module:Requested move}}
[[{{NAMESPACE}}{{colon}}{{ROOTPAGENAME}}]], with the assistance of [[User:RMCD bot|RMCD bot]], populates [[Wikipedia:Requested moves/Current discussions]] and [[:Category:Requested moves]].

This template is substituted for [[input validation]] and archiving reasons (so a permanent record of the proposed page name can be placed on the talk page).

Edits to this template, and [[Module:Requested move]], which it invokes, can adversely affect RMCD bot. Please check edits with the bot operator before implementation.

==Usage==
===Specified new name===
Use this template to tag articles with a [[Wikipedia:Requested moves#Requesting controversial and potentially controversial moves|controversial or potentially controversial move request]]. For uncontroversial/technical requests, use {{tls|RMassist}}.

This template should be substituted into the talk page of the article to be moved. It is not placed in the article itself.

Please note that unlike {{tl|Article for deletion}}, the discussion for a page move must take place on the [[Help:talk page|talk page]], '''not''' on [[Wikipedia:Requested moves]].

Add this template at the bottom of the talk page of the page that you want to be moved. It should be formatted like this:

<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:Requested move |NewName |reason=Why&nbsp;...}}
</pre>

Where:
*{{mono|{{var|NewName}}}} = your proposed new name for the page, i.e., the name which the page should be renamed or moved to
*{{mono|{{var|Why&nbsp;...}}}} = your rationale for the proposed page name change, ideally referring to applicable naming convention policies and guidelines, and providing evidence in support where appropriate
**Please do not include templates that expand to tables, such as nav templates or {{tl|Not a ballot}}, and also avoid collapse templates such as {{tl|collapse}} and {{tl|hidden}}. Templates like {{tl|Not a ballot}} can go in the line above the requested move banner.
**If such extra information is required in the nomination, please post it afterwards as a comment. 
This will create a template (see [[Template:Requested move/dated]]) in a new section on the talk page, and links to the old page and new page. For example:

<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:Requested move |Template:Move |reason="Move" was the original name of this template, and we should revert to that.}}
</pre>

will create:

<div style="border:2px inset #222222;padding:4px;">
{{fake heading|Requested move {{#time: j F Y | {{CURRENTTIMESTAMP}} }}}}
{{Requested move/dated/mirror|Template:Move}}

[[Template:Requested move]] → {{no redirect|Template:Move}} – "Move" was the original name of this template, and we should revert to that. Username (talk) {{CURRENTTIME}}, {{#time: j F Y | {{CURRENTTIMESTAMP}} }} (UTC)
</div>

[[User:RMCD bot]] will copy the move information to [[Wikipedia:Requested moves|WP:RM]], usually within 20 minutes.

===Unspecified new name===
If you're unsure about what the best new name is, use a question mark for the new name.

<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:Requested move |? |reason=The name should be either "move" or "rename", let's discuss which is better.}}
</pre>

creates:

<div style="border:2px inset #222222;padding:4px;">
{{fake heading|Requested move {{#time: j F Y | {{CURRENTTIMESTAMP}} }}}}
{{Requested move/dated/mirror|?}}

[[Template:Requested move]] → ? – The name should be either "move" or "rename", let's discuss which is better. Username (talk) {{CURRENTTIME}}, {{#time: j F Y | {{CURRENTTIMESTAMP}} }} (UTC)
</div>

===Custom heading===
You may also ask the template to override the default heading by supplying a value to the {{para|heading}} parameter ({{para|header}} will also work).

<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:Requested move |Template:Rename |reason=Rename is a more intuitive term. |heading=Rename this?}}
</pre>

creates:

<div style="border:2px inset #222222;padding:4px;">
{{fake heading|Rename this?}}

{{requested move/dated/mirror|Template:Rename}}

[[:Template:Requested move]] → {{no redirect|Template:Rename}} – Rename is a more intuitive term. Username (talk) {{CURRENTTIME}}, {{#time: j F Y | {{CURRENTTIMESTAMP}} }} (UTC)
</div>

===Shared talk pages===
If the talk page is a redirect, you may start the discussion on the target's talk page.

In the following example, the talk page of the page to be moved, [[WT:WikiProject Articles for creation/Resources]], redirects to its parent talk page, [[WT:WikiProject Articles for creation]]. The below code would be placed on the latter to centralize discussion:
<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:requested move |reason=(the reason for the page move goes here). |current1=Wikipedia:WikiProject Articles for creation/Resources |new1=Wikipedia:WikiProject Articles for creation/Reviewing and templates}}
</pre>

Instead of the {{para|1}} unnamed parameter, the {{para|current1}} and {{para|new1}} parameters are used. The method is similar to the one under [[#Multiple related move requests]]. This creates:

<div style="border:2px inset #222222;padding:4px;">

{{fake heading|Requested move {{#time: j F Y | {{CURRENTTIMESTAMP}} }}}}

{{Requested move/dated/mirror|multiple=yes|current1=Wikipedia:WikiProject Articles for creation/Resources|new1=Wikipedia:WikiProject Articles for creation/Reviewing and templates}}

* [[:Wikipedia:WikiProject Articles for creation/Resources]] → {{no redirect|Wikipedia:WikiProject Articles for creation/Reviewing and templates}}
– (the reason for the page move goes here). Username (talk) {{CURRENTTIME}}, {{#time: j F Y | {{CURRENTTIMESTAMP}} }} (UTC)
</div>

===Multiple related move requests===
Related moves should be combined into a single request. This is particularly applicable when changing a [[WP:primary topic|primary topic]], which generally requires moving at least a disambiguation page and another related page. Additional proposed moves should be formatted like this:

<pre style="border:2px inset #222222;padding:4px;margin:1em;background-color:white;width:60%;white-space:pre-wrap;">
{{subst:Requested move
|NewName |reason=Why ...
|current2=Current title of page 2
|new2=New title for page 2
|current3=Current title of page 3
|new3=New title for page 3
...
|currentN = Current title of page N
|newN = New title for page N
}}
</pre>

Where:
*{{mono|{{var|NewName}}}} = your proposed new name for page 1, i.e., the page whose talk page is being used for the discussion
*{{mono|{{var|N}}}} = the number of pages which are proposed for moves

Occasionally the discussions for significant multi-move requests may be hosted on [[WP:WikiProject|WikiProject]] talk pages or other pages in [[Wikipedia:Project namespace|Project namespace]]. For multi-move discussions hosted on a page which is not itself proposed to be moved, specify {{para|current1|Current title of page 1}} for the first page to move.

===Adding survey and discussion subsections===
Use the code {{para|talk|yes}} to append the subsections in {{tl|Requested move/talk}}.

===Suppressing the signature or the section heading===
This template automatically adds a [[WP:SIG|signature]] to the requested move reason unless it appears to be already signed. To suppress the signature, you can use the code {{para|sign|no}}. To suppress the section heading, {{para|heading|no}} ({{para|header|no}} will also work).<br />
Requested moves are required to have a section heading and signature, so these parameters should rarely be used, generally only by experienced editors repairing malformed requests.

==Default behavior==
*If neither parameter {{para|1}} nor {{para|new1}} are specified, then '''?''' – an unspecified destination to be decided on the talk page – is assumed
*If neither parameter {{para|2}} nor {{para|reason}} are specified, the default text is "Please place your rationale for the proposed move here." This text should be edited to replace it with an actual rationale for the requested move, or the request will be rejected.

==Deprecated parameter==
*Use of unnamed parameter {{para|2}} is not encouraged, because an unnamed parameter doesn't support a rationale containing an equals sign (often in web links, custom signatures, etc.), due to MediaWiki bug {{phab|T16235}}.

==Error messages==
This template validates editor input, and may write one of the following messages if it's not used as intended. These errors are not reported at [[Wikipedia:Requested moves|WP:RM]]. If you need help using this template, review the instructions given at [[Wikipedia:Requested moves#Requesting controversial and potentially controversial moves|requesting controversial and potentially controversial moves]]. If you still need help, post a question at [[Wikipedia talk:Requested moves]].
*{{strongbad|class=error|1=This template must be [[Wikipedia:Template substitution|substituted]]. Replace <nowiki>{{Requested move ...}} with {{subst:Requested move ...}}</nowiki>.}}
*{{strongbad|class=error|1=[[Template:Requested move]] must be used in a TALKSPACE, e.g., [[{{TALKPAGENAME}}]]}}
*{{strongbad|class=error|1=Request to move a single page must be placed on that page's talk or the page its talk redirects to}}
*{{strongbad|class=error|1=Must create ''[["Title"]]'' before requesting that it be moved}}
*{{strongbad|class=error|1=[[Template:Requested move]] is not for categories, see [[Wikipedia:Categories for discussion]]}}
*{{strongbad|class=error|1=[[Template:Requested move]] is not for files, see [[Wikipedia:Moving a page#Moving a file page]] (use [[template:Rename media]] instead)}}
*{{strongbad|class=error|1=[[Template:Requested move]] is not for moves from draft or user space.<br>If you would like to submit your draft for review, add <code>{{tlf|subst:submit}}</code><br>Otherwise, see [[Help:How to move a page]] for instructions.<br>If you cannot move it yourself, see [[Wikipedia:Requested moves#Requesting technical moves|Requesting technical moves]].}}
*{{strongbad|class=error|1=Invalid character "{{var|character}}" found in the "{{var|parameter}}" parameter}} – A pagename cannot contain any of the following characters: <nowiki>#&nbsp;<&nbsp;>&nbsp;[&nbsp;]&nbsp;{&nbsp;}</nowiki>
*{{strongbad|class=error|1=Invalid title detected in parameter "{{var|parameter}}"; check for [[Wikipedia:Page name#Technical restrictions and limitations|invalid characters]]}} – There are other invalid characters and character sequences, e.g. [[./]]
*{{strongbad|class=error|1=Invalid title detected in parameter "{{var|parameter}}"; has [[Help:Interwiki linking|interwiki prefix]] "{{var|interwiki prefix}}"}} (e.g. [[wikt:]])
*{{strongbad|class=error|1=Duplicate title detected ("{{var|Title}}"); cannot move the same page to two different places}} (applicable to [[#Multiple related move requests|multiple related move requests]])
*{{strongbad|class=error|1="current2" parameter missing; please add it or remove the "new2" parameter}} (applicable to [[#Multiple related move requests|multiple related move requests]])

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "New name",
			"type": "wiki-page-name",
			"description": "The proposed title for the page",
			"suggested": true
		},
		"reason": {
			"label": "Reason",
			"type": "string",
			"required": true,
			"description": "The reason for the proposed page title"
		},
		"heading": {
			"label": "Custom heading",
			"description": "Suppresses the default heading and adds a custom section title",
			"type": "string"
		},
		"sign": {
			"label": "Signature",
			"description": "Suppresses the signature if set to no",
			"type": "boolean"
		}
	},
	"description": "The templates should always be substituted! This template begins a discussion about a controversial or a potentially controversial move. It must be used on the talk page.",
	"format": "inline",
	"paramOrder": [
		"1",
		"reason",
		"heading",
		"sign"
	]
}
</templatedata>

==See also==
*{{tl|RM notice}}
*{{tls|RMassist}}
*{{tl|Rename media}}
*{{tls|Requested move/end}}
*{{tl|Old move}}, for listing previous RMs on talk pages
*[[Wikipedia:Template messages/Moving]]
*[[Wikipedia:Requested moves]]
*[[Wikipedia:Categories for discussion]]

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Wikipedia page-name maintenance templates]]

}}</includeonly>