Editing Template:Shortcut/doc (section)

== Usage ==
This template should not be used for articles in the main namespace, because the graphic produces an unavoidable [[WP:SELF|self-reference]].

In templates, it is put in the [[Wikipedia:Template documentation|documentation page]].

# Insert the shortcut template. 
# Create a redirect page with the {{tl|R from shortcut}} template suffixed to the redirect. Name the page after your shortcut name.  Include the namespace name in both the shortcut name and the redirect page name. For example, substitute your own shortcut name as the title of the page, and substitute the proper namespace, then add the REDIRECT as the top-line on your redirect page, and the category to the third line of the redirect:
#:<code><nowiki>#REDIRECT [[</nowiki>''Namespace'':''Title of page with''#''Optional and possibly very long section name''<nowiki>]]</nowiki><br><br><nowiki>{{R from shortcut}}</nowiki></code>
# Verify operation.  Note that shortcut templates should display in all capitals, but operate without all capitals.

'''Notes'''
Shortcuts are used mainly on user pages and talk pages in reference to the Wikipedia, Help, and Portal namespaces. These templates inform about the shortcuts available to the page they are on. For example, [[WP:SHORT]] redirects to [[Wikipedia:Shortcut]] and therefore, Wikipedia:Shortcut renders a shortcut box listing WP:SHORT.  It is a self-reference that is normally avoided in the main article namespace.

'''Do not list every single redirect for a page'''.  Per the [[WP:LINKBOXES]] guideline, list the most common and easily remembered redirects.  Use [[Special:WhatLinksHere]] and https://pageviews.wmcloud.org/ to determine which ones are most commonly used.  Most linkboxes only show one shortcut.  It is rare for three or more shortcuts to be commonly used.