View source for Template:Gs/alert/doc

{{Documentation subpage}}
{{subst only|auto=yes|actualtemplate={{tlsp|Gs/alert|<i>topic code</i>}}}}__NONEWSECTIONLINK____NOTOC__<includeonly>__NOEDITSECTION__
</includeonly>

===Usage===

Community-authorised [[Wikipedia:General sanctions|general sanctions]] (GS) are in effect for some topics on Wikipedia. Users editing these pages may be [[Wikipedia:General sanctions#Awareness and alerts|alerted]] that general sanctions are in effect. You must use this template to do so.

Alerts ensure a user knows what is expected of them. Alerts are a neutral courtesy; never use them to intimidate, coerce, or shame another editor.

To alert a user, open a new section on their user talk page. Paste the following code into it, replacing <code>''topic code – see list''</code> with the corresponding code from [[#Codes|the table]] below. Type an appropriate subject line, then save the page.

{{pre|1={{[[Wikipedia:Substitution|subst]]:Gs/alert|<u>''topic code here'' – select from [[#codes|list]]</u>}} <nowiki>~~~~</nowiki>}}

===Logging===

Using this template will trigger [[Special:AbuseFilter/602|EditFilter 602]]. As a result, your edit containing the alert will be [[Wikipedia:Tags|tagged]] with "discretionary sanctions alert". Edits with this tag can be searched for in user contributions, user talk page histories, [[Special:RecentChanges]], and the [[Special:AbuseLog|log of EditFilter 602]].

Therefore, an automatic system log of all alerts is maintained. You need not do anything except leave the alert.

To see whether a user has been alerted to general sanctions, load the history of their user talk page and search for <code>discretionary sanctions alert</code> under the 'tag filter' field. You can use the {{tl|Ds/log}} template (usually alongside {{tl|user}} in noticeboard reports) to quickly generate links for conducting searches of issued alerts.

Additionally, current instances of the template are tracked [{{fullurl:Special:WhatLinksHere/Template:Z33|hidelinks=1}} here] and counted [//tools.wmflabs.org/templatecount/index.php?lang=en&name=Z33&namespace=10#bottom here]. Alerts that were subsequently deleted from the user's talk page will only appear in the EditFilter log, so this is the primary tracking mechanism.

===Codes===

When leaving a user an Alert, you must replace <code>{{!}}''topic code – select from list''</code> with the relevant topic code:

{{Gs/topics/table|subst=y}}
<!--
===Advanced users' notes===
* Substituted instances of this template are tracked using the Z-number template {{tl|Z33}}. Use of this template can be tracked at [[Special:WhatLinksHere/Template:Z33]].
* Edits containing a substituted instance of this template will trigger AbuseFilter 602. The exact text which triggers the AbuseFilter are declared in the publicly-viewable [[Special:AbuseFilter/602|filter conditions]].
* If the parameter {{para|1}} fails to display, {{para|topic}} or {{para|t}} can be used instead.
* This template will return an error if:
**{{para|1}} or an equivalent is not declared;
**the template is not substituted; or
**the template is used outside the user talk or user namespaces.
* [[Template:Alert]] is a [[WP:Redirect|redirect]] to [[Template:Ds/alert]]. Instructions for this template, ''Ds/alert'', are often given with reference to the template name ''Alert''. This is for brevity's sake; the two template names refer to the same actual template.
* Information on adding {{em|new}} topic areas to the index above is given at the bottom of [[Template:Ds/topics/single notice]], which is displayed {{#ifeq:{{PAGENAME}}|Template:Ds/alert|below|at the bottom of the [[Template:Ds/alert|main template page]]}}.
* This template is included in [[:Category:Wikipedia templates to be automatically substituted]], so AnomieBOT will automatically substitute it. (As the template returns an error if used unsubstituted, AnomieBOT will not have to frequently, if ever, do this.)
-->
{{Gs/topics/single notice}}

<includeonly>{{Sandbox other||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:User warning templates]]
[[Category:Standardised Wikipedia community-authorised general sanctions templates]]
}}</includeonly>