Template:Talkback/doc

Purpose
In simplest terms, talkback allows a user (user1) to direct the attention of another user (user2) to a discussion on a specific talk page.

One benefit of this tool is to maintain the flow of a discussion on a single user's talk page, rather than having to switch back and forth between talk pages in order to make sense of the conversation.

Two examples of the use of this template are:


 * If you receive a message from a user, you can notify the user that you have responded to his/her message on your own talk page.
 * If you create a topic on your talk page, you can notify a user that the discussion might need his/her attention.

Usage
In this discussion, it is assumed that you (the sender) are user1 and that user2 is the recipient.

First message
Place this template under a new section at the bottom of user2's talk page. To use this template to direct the attention of another Wikipedian to your talk page:


 * 1) Go to the recipient's talk page. User talk pages start with "User talk:" prefix.
 * 2) On the top of the page, click on "New Section" button/link. It should look like this: New section small.png
 * 3) In the "Subject/headline" box, type "Re: " and the subject of the original discussion.
 * 4) In the message section, enter one of the following (remember, you are user1):
 * 5) *Simple form: This is the simplest way to use this template:"".
 * 6) *More accurate form: This form has an additional parameter but takes the reader right to the section in which the discussion is in progress:""
 * 7) *Recommended form: This form is complete and recommended. It adds a timestamp:""Instead of five tildes, you can enter any date and time.
 * 8) Save the page.

Wikipedia will notify user2 of having a new message in his/her talk page. When (s)he visits his/her talk page, (s)he should see your notice and (hopefully) follow the link to your user talk page.

Example
For example, this code:

Re: Testing on Wikipedia
Generates: 

NOTE: This example says "Hello, Talkback" only because this page is for Talkback. In real use it would have the name of the recipient: "Hello, user2".

Shortcut
Instead of manually typing out the username parameter, you may use, which automatically inserts your username.

Second message
So, what if you had another reply for the same user in the same topic? In case you think that the recipient has not visited your user talk page since you inserted the notice, simply do nothing. On the other hand, if the discussion continued and you think the recipient must once again read what you have posted, you can simply do one of the following:
 * 1) Do nothing. Most of the time, Wikipedians keep their correspondents' user talk pages in their watchlists and will see when another reply is posted.
 * 2) Update the ts parameter. Simply edit the recipient's user talk page and replace the time and date in the ts parameter with a new time and date (or with ). This will notify the user.
 * 3) Add another in the same section under the first one. However, the recipient user might find this obtrusive.

Pointing to other talk pages
To have the links point to a non-user talk page, you must include the full talk page link.



For example, suppose talkback should be used to link to Help talk:Using talk pages:
 * Example:

Announcing your conversation policy
If you are going to use this template, please consider putting on the top of your own talk page. It generates:

You may also use, which tells your visitors not to use. It generates:

NOTE: These examples say " " only because this page is for Talkback. In real use they would show your own username: " ". Where the first example says " ", it would appear just like that: The "you" there is addressed to the person reading the notice that the   template will put at the top of your User Talk page.

You might, however, like to make a custom message using mbox or notice.

TemplateData
{ "description": "A template for notifying users that they have messages waiting on other pages", "params": { "1": {     "label": "User name", "description": "The username of the recipient.", "required": true, "type": "string" },   "2": {      "label": "Status", "description": "The linked page or page section", "required": false, "type": "string" } } }