View source for Template:Ds/talk notice/doc

{{Documentation subpage}}
{{Nosubst}}
{{template display|nomobile}}
{{TOCright}}
This template warns people on the talk page that arbitration discretionary sanctions have been authorised. Discretionary sanctions allow administrators to act quickly and decisively to prevent misconduct.

The template requires you to declare which arbitration decision authorised discretionary sanctions, by specifying a [[#Decision codes|#decision code]].

You should place the template at the top of the talk page, below the header (if used) but above all other templates.

The template places the page into [[:Category:Wikipedia pages under discretionary sanctions]] or [[:Category:Pages with discretionary sanctions editnotice]] depending on usage unless <code>nocat=yes</code> is included.

Anyone may place a discretionary sanctions talk page notice.<ref>[[Wikipedia talk:Arbitration Committee/Archive 21#Who can place Talk page notices of ACDS page restrictions and when]]</ref>

The page it is placed on must be within the topic area of the arbitration case. Keep in mind that many topic areas are "broadly construed". Clarification of whether a page is in a topic area can be requested at [[Wikipedia:Arbitration/Requests/Clarification and Amendment]].

=== Use ===
You may use this on the article talk page. You may also use it in an article edit notice for general information; however, edit notices about a special "page restriction" deployed under discretionary sanctions should instead be advertised using the special ''{{tl|Ds/editnotice}}'' template.

:{{tlx|Ds/talk notice|'''''code'''''}}
:{{tlx|Ds/talk notice|'''''code'''''|'''''brief'' <u>or</u> ''long'''''}}

{| class="wikitable"
!Parameter
!Values
!Behaviour
|-
|{{para|1}} (or {{para|topic}}) || {{var|code}}: Choose from [[#Decision codes]] below; e.g. {{para|topic|tt}} for ''The Troubles''. || Determines which arbitration final decision will be linked to.
|-
|{{para|2}} (or {{para|style}}) || {{var|brief}} or {{var|long}}; see [[#Styles]] for what each looks like. || Determines whether the longer or shorter form will be displayed. Optional; defaults to {{para|style|long}}.
|-
|{{para|restriction}} || Custom text or {{code|1RR}} || Custom text used to define a sanction. {{para|restriction|1RR}} can be specified to insert "You must not make more than one revert per 24 hours on this article." Optional.
|}

Empty templates, for copy-pasting:
:{{tlx|Ds/talk notice|<!---->}}
:{{tlx|Ds/talk notice|<!---->|<!---->}}

=== Styles ===

The default is a wordy and detailed message:

{{tlx|Ds/talk notice|saq|'''long'''}} gives:
{{Ds/talk notice|topic=saq|style=long|nocat=yes}}

Alternatively there is a more concise, bold-print message:

{{tlx|Ds/talk notice|tpm|'''brief'''}} gives:
{{Ds/talk notice|topic=tpm|style=brief|nocat=yes}}

=== Decision codes ===

{{Ds/topics/table}}

If an article has sanctions but doesn't fit into one of the above topic areas, this template is unsuitable. Use {{tl|sanctions}} instead.

== See also ==
*'''{{tl|Gs/talk notice}}''': an equivalent for when any general sanction is in use (for instance, Wikipedia community general sanctions). This template is used only for arbitration discretionary sanctions.
*'''{{tl|Ds/alert}}''': the template for alerting individual users to the existence of discretionary sanctions, as required under the system rules.

{{Ds/topics/single notice}}

<includeonly>{{Sandbox other||
<!-- Categories and interwikis go here: -->
[[Category:Standardised Wikipedia arbitration enforcement templates]]
[[Category:Non-subject-matter-related article-talk header templates]]
}}</includeonly>