Template:Template for discussion/doc: Difference between revisions
Minor addition to instruction as a result of the discussion at [[Template_talk:Template_for_discussion#Template-protected_edit_request_on_29_August_2015]. |
SMcCandlish (talk | contribs) →Display on articles: Our readers do not care about internal discussions of this sort and shouldn't be bludgeoned with these templates. In ten years, I've never once that I recall had someone revert me noincluding a TfD notice. |
||
Line 16: | Line 16: | ||
=== Display on articles === |
=== Display on articles === |
||
Unless you do something unusual such as enclosing in [[wp:noinclude|noinclude]] tags, articles that use the nominated template will provide a notification and link to the discussion. By default the article will show the following just above the display of the nominated template: |
Unless you do something unusual such as enclosing in [[wp:noinclude|noinclude]] tags, articles that use the nominated template will provide a notification and link to the discussion. {{strong|This is generally undesirable, and can be very disruptive to our readers' use of the encyclopedia}}, especially with inline templates, and frequently used templates. By default the article will show the following just above the display of the nominated template: |
||
{{Template for discussion/dated|demospace=main}} |
{{Template for discussion/dated|demospace=main}} |
||
There are various other options, specified by the {{para|type}} parameter. |
There are various other options, specified by the {{para|type}} parameter, if for some reason it is thought that the TfD notice should appear where the template is transcluded. This is mostly only appropriate for templates used exclusively outside of mainspace, e.g. those relating to policypages or wikiprojects. |
||
==== Inline ==== |
==== Inline ==== |
Revision as of 00:48, 13 September 2015
![]() | This is a documentation subpage for Template:Template for discussion. It may contain usage information, categories and other content that is not part of the original template page. |
![]() | This template should always be substituted (i.e., use {{subst:Template for discussion}} ). |
![]() | Any breaking changes to this template, including moving it or nominating it for deletion, must be communicated in advance to Twinkle's users and maintainers at Wikipedia talk:Twinkle. The standard installation of Twinkle relies on this template. Thank you. |
![]() | Substituting this template creates a dated version, you should not substitute the dated version. |
This template is used to nominate a template for discussion.
Basic usage
Substitute this template onto the template you wish to nominate, i.e. add the following code to the top of the template page and press save.
{{subst:Template for discussion}}
Nominating a group of templates
To nominate multiple templates for deletion under the same heading, use the |heading=
parameter to specify the heading under which the discussion is taking place. Type the following at the top of each individual template:
{{subst:Template for discussion|heading=HEADING}}
where HEADING is the name of the section heading under which you will list the templates for deletion.
Display on articles
Unless you do something unusual such as enclosing in noinclude tags, articles that use the nominated template will provide a notification and link to the discussion. This is generally undesirable, and can be very disruptive to our readers' use of the encyclopedia, especially with inline templates, and frequently used templates. By default the article will show the following just above the display of the nominated template:
There are various other options, specified by the |type=
parameter, if for some reason it is thought that the TfD notice should appear where the template is transcluded. This is mostly only appropriate for templates used exclusively outside of mainspace, e.g. those relating to policypages or wikiprojects.
Inline
To nominate inline templates, set |type=inline
. This will help with formatting issues that occur when the large notification is displayed. Type the following:
{{subst:Template for discussion|type=inline}}
The notification on articles looks like this:
Tiny
To use even smaller notifications, for inline template nominations, set |type=tiny
. Type the following
{{subst:Template for discussion|type=tiny}}
which will produce the following notification:
Sidebar
To nominate templates that are used as sidebars, such as infoboxes, specify |type=sidebar
, i.e.
{{subst:Template for discussion|type=sidebar}}
which produces:
You can alternatively use |type=infobox
or |type=box
to produce the same result.
Disabled
Finally it is possible to disable the notification completely by typing |type=disabled
. You can use this when everything else fails.
{{subst:Template for discussion|type=disabled}}
Which type should be used?
For example, suppose that a template called {{Raisins}} outputs the link "dried grapes". Here's how it might appear in an article:
If the default type were to be inserted into the template, the following would result:
And it is impossible for the reader to identify the template which is under discussion.
Using |type=inline
instead generates the following result:
The downside is a greater degree of interference with the article's text, so the decision of which type to use should be made on a case-by-case basis. In rare cases, where the insertion of any template is deemed too detrimental to a large number of articles, it might be advisable to disable the notifications completely.
Categorisation
Templates that transclude this template will be added to Category:Templates for deletion.