Template:Please see/doc

This template is meant to be subst:ed on the talk pages of users whose attention you would like to draw to a discussion, or on the talk pages of other pages whose watchers might have an interest in the discussion. Please read Canvassing before using this template. The location parameter is for the page at which the discussion is taking place. For the convenience of the recipient, be sure to link directly to the section header.

The heading parameter may be used for a concise, neutral description of the heading under discussion. The more parameter is an option chance to add a little more discussion to the invitation. These can be helpful when the section title alone might not sufficiently communicate what a discussion is about, as editors are more likely to take up an invite if this is made clear. Using an edit summary like  can also help make invites more effective, as it allows recipients to follow them directly from their watchlist.

This template will automatically add your signature ( "~" ), so please do not add it.

Afterwards, you may use at the discussion page to inform the discussion participants of your notification.

Parameters

 * location (REQUIRED) : the page at which the discussion is happening. If not labelled as "location," then uses the first parameter. If linking to a specific section, include the  and the section header in this part (e.g. Talk:Main Page#Cabal)
 * section (OPTIONAL) : optional section header for the location of the discussion
 * piped (OPTIONAL) : if set to any value, this will pipe the link used to match the section
 * heading (OPTIONAL) : the heading name for the user's talk page. If not labelled as "heading," then uses the second parameter. If there is no second parameter, then uses location. If value   is used, automatic heading is disabled.
 * more (OPTIONAL) : more discussion to add to the invitation.
 * noimage (OPTIONAL) : if set to any value, it will turn off the icon

Detailed example
For example, you wanted to discuss the deletion and redirecting of the article Pussycat to the article Cat. A discussion could take place at Talk:Pussycat; you could then place the wikitext  in the Talk:Cat page. When the edit was saved, it would substitute it with the text:



Example 1


Becomes:

Example 2


or

or

Becomes:

Example 3


Becomes:

Redirects

 * pls
 * See discussion

TemplateData
{	"description": "A template to be substituted on the talk pages of users whose attention you would like to draw to a discussion. Please read Wikipedia:Canvassing before using this template.", "params": { "location": { "label": "location", "type": "wiki-page-name", "required": true, "description": "The exact location where the discussion is taking place. IF POSSIBLE, link directly to the heading of the talk thread.", "aliases": [ "1"			]		},		"section": { "label": "section", "type": "wiki-page-name", "required": false, "description": "The heading of the talk thread that you want them to see." },		"piped": { "label": "piped", "type": "string", "required": false, "description": "Set this to any value to use the heading of the talk thread as a piped link" },		"heading": { "label": "heading", "type": "string", "description": "The heading of the thread that will be started on the talk page of the user. If this parameter is not provided, then the default heading will be a copy of the link you provide. If value 'no' is provided, the template won't generate a heading.", "aliases": [ "2"			],			"suggested": true },		"more": { "label": "more", "type": "string", "description": "A concise, neutral description of the discussion that will be inserted before your signature and after the \"You are invited\" sentence.", "suggested": true },		"noimage": { "label": "noimage", "type": "boolean", "required": false, "description": "Set this to any value to turn off the icon" },		"keepunderscore": { "label": "Keep underscore?", "description": "Set to yes to override this template's attempt to remove underscores (_) that get left in when a discussion link is copied from a URL.", "type": "boolean" },		"italicizepage": { "label": "Italicize page?", "description": "Italicizes the page name", "type": "boolean" },		"italicizesection": { "label": "Italicize section?", "description": "Italicizes the section name", "type": "boolean" }	} }