Template:Delete/doc

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Default messages: Added a little more information to describe how to use built-in messages)
(Added documentation for {{delete|mistake}})
 
(4 intermediate revisions by one user not shown)
Line 3: Line 3:
 
Page deletions should usually be reserved for mistakes, as a deleted page may break links. For pages that have been moved, use a [[Help:Redirects|redirect]]. For pages with obsolete content, try merging the content into other articles and then providing a redirect to an appropriate location.
 
Page deletions should usually be reserved for mistakes, as a deleted page may break links. For pages that have been moved, use a [[Help:Redirects|redirect]]. For pages with obsolete content, try merging the content into other articles and then providing a redirect to an appropriate location.
  
To use, insert <code><nowiki>{{delete}}</nowiki></code> which will display a default message. To include a reason for the request, insert <code><nowiki>{{delete|This page really needs to be deleted.}}</nowiki></code>.
+
To use this template, insert <code><nowiki>{{delete}}</nowiki></code> which will display a default message. To include a specific reason for the request, insert <code><nowiki>{{delete|This page really needs to be deleted.}}</nowiki></code>. Since pages usually get deleted for similar reasons, built-in messages exist to encourage reuse and consistency. A built-in message may be used by providing the name of that message. For example, both <code><nowiki>{{delete|random}}</nowiki></code> and <code><nowiki>{{delete|mysterious}}</nowiki></code> indicate that the page should be deleted due to meaningless or nonsensical content.
 +
 
 +
== Standard responses ==
 +
This template has built-in reasons for some common scenarios which can be automatically included in lieu of a full reason. For example, request the deletion of a [[Help:Sandbox|sandbox]] by inserting <code><nowiki>{{delete|sandbox}}</nowiki></code>. Many aliases also exist for these messages, such as "senseless", "not useful", and "nonsense" to refer to "random".
 +
 
 +
=== random ===
 +
The "random" message is used for a page that appears to have been used to test out the wiki. Some examples include nonsense such as a single word or letter.
 +
{{delete|random}}
 +
=== irrelevant ===
 +
The "irrelevant" message is used for a page that does not appear to be relevant to this project. Some examples include random code listings or a list of files.
 +
{{delete|irrelevant}}
 +
=== obsolete ===
 +
The "obsolete" message indicates a page is no longer used. This should only be used for pages that do not have historical value.
 +
{{delete|obsolete}}
 +
=== mistake ===
 +
The "mistake message indicates a page was created by accident. This should only be used if the page was created in error, such as a incorrect filename or a uncommon misspelling. Common misspellings should be changed to redirects.
 +
{{delete|mistake}}
  
 
== Examples ==
 
== Examples ==
=== Example: Basic delete request ===
+
=== Basic delete request ===
 
This example demonstrates a basic request for deletion.
 
This example demonstrates a basic request for deletion.
 +
<pre><nowiki>{{delete|random}}</nowiki></pre>
 +
''Output'':
 +
{{delete|random}}
  
''Code:''
+
=== Specific delete request ===
<pre><nowiki>{{delete|This page is no longer used.}}</nowiki></pre>
+
This example demonstrates a request for deletion with an explicit reason.
 +
<pre><nowiki>{{delete|This page is upside-down.}}</nowiki></pre>
 
''Output'':
 
''Output'':
{{delete|This page is no longer used.}}
+
{{delete|This page is upside-down.}}
  
=== Example: Minimal delete request ===
+
=== Minimal delete request ===
 
This example demonstrates the default request for deletion.  
 
This example demonstrates the default request for deletion.  
 
''Code:''
 
 
<pre><nowiki>{{delete}}</nowiki></pre>
 
<pre><nowiki>{{delete}}</nowiki></pre>
 
''Output'':
 
''Output'':
 
{{delete}}
 
{{delete}}
 
== Default messages ==
 
This template has built-in reasons for some common scenarios which can be automatically included in lieu of a full reason. For example, request the deletion of a [[Help:Sandbox|sandbox]] by inserting <code><nowiki>{{delete|sandbox}}</nowiki></code>.
 
 
=== Sandbox ===
 
This message is used for pages that appear to have been used to test out the wiki.
 
 
''Code:''
 
<pre><nowiki>{{delete|sandbox}}</nowiki></pre>
 
''Output'':
 
{{delete|sandbox}}
 
 
=== Mystery ===
 
This message is used for a page that does not appear to have a relevant purpose. It may actually have been a sandbox, but there's not enough context to determine if that's the case.
 
 
''Code:''
 
<pre><nowiki>{{delete|mystery}}</nowiki></pre>
 
''Output'':
 
{{delete|mystery}}
 

Latest revision as of 05:35, 4 July 2010

Template:Delete is an admonition that indicates a page should be deleted. This template makes these pages easier for administrators to find and work through, especially if a reason is provided.

Page deletions should usually be reserved for mistakes, as a deleted page may break links. For pages that have been moved, use a redirect. For pages with obsolete content, try merging the content into other articles and then providing a redirect to an appropriate location.

To use this template, insert {{delete}} which will display a default message. To include a specific reason for the request, insert {{delete|This page really needs to be deleted.}}. Since pages usually get deleted for similar reasons, built-in messages exist to encourage reuse and consistency. A built-in message may be used by providing the name of that message. For example, both {{delete|random}} and {{delete|mysterious}} indicate that the page should be deleted due to meaningless or nonsensical content.

Contents

[edit] Standard responses

This template has built-in reasons for some common scenarios which can be automatically included in lieu of a full reason. For example, request the deletion of a sandbox by inserting {{delete|sandbox}}. Many aliases also exist for these messages, such as "senseless", "not useful", and "nonsense" to refer to "random".

[edit] random

The "random" message is used for a page that appears to have been used to test out the wiki. Some examples include nonsense such as a single word or letter.

Cog.png
It has been requested that this page be deleted.
This page does not appear to have useful content. If you're looking to experiment with the wiki, please use your user page as a sandbox.

[edit] irrelevant

The "irrelevant" message is used for a page that does not appear to be relevant to this project. Some examples include random code listings or a list of files.

Cog.png
It has been requested that this page be deleted.
The content of this page does not seem related or relevant to this wiki. If you're looking for a place to paste snippets of text, please use fpaste.org.

[edit] obsolete

The "obsolete" message indicates a page is no longer used. This should only be used for pages that do not have historical value.

Cog.png
It has been requested that this page be deleted.
This page is obsolete or outdated. It does not have sufficient historical value, and it cannot be usefully merged into another page.

[edit] mistake

The "mistake message indicates a page was created by accident. This should only be used if the page was created in error, such as a incorrect filename or a uncommon misspelling. Common misspellings should be changed to redirects.

Cog.png
It has been requested that this page be deleted.
This page was created accidentally and should never be used.


[edit] Examples

[edit] Basic delete request

This example demonstrates a basic request for deletion.

{{delete|random}}

Output:

Cog.png
It has been requested that this page be deleted.
This page does not appear to have useful content. If you're looking to experiment with the wiki, please use your user page as a sandbox.


[edit] Specific delete request

This example demonstrates a request for deletion with an explicit reason.

{{delete|This page is upside-down.}}

Output:

Cog.png
It has been requested that this page be deleted.
This page is upside-down.


[edit] Minimal delete request

This example demonstrates the default request for deletion.

{{delete}}

Output:

Cog.png
It has been requested that this page be deleted.