View source for Template:Guideline/doc

{{Documentation subpage}}
{{Template notes |style=margin-bottom:1.0em;
| This template should only be used on pages that are formal [[WP:Policies and guidelines|Wikipedia guidelines]].
| For advice that is {{em|not}} a Wikipedia guideline, use the {{tl|Essay}} or one of its variants, instead.
| Please do not apply this template to any page without first advertising your [[WP:PROPOSAL|proposal]] to other editors via a [[WP:RFC|request for comments]], as described below.
}}

This template is for [[WP:Policies and guidelines|formal Wikipedia guidelines]] that can be classified more specifically by topic. For the rare case of a guideline that does not suit any of these categorizations, you can use {{tl|Guideline}}.

==Usage==
:{{tlx|{{PAGENAME}}|{{gray|section{{=}}}}|{{var|guideline category}}|{{var|category sort key}}|{{var|shortcut}}|...|{{var|shortcut5}}}}

==Template parameters==
*For <kbd>{{var|guideline category}}</kbd>, use one of the following:
** <kbd>behavioral guideline</kbd>
** <kbd>content guideline</kbd>
** <kbd>deletion guideline</kbd>
** <kbd>editing guideline</kbd>
** <kbd>naming convention</kbd>
** <kbd>notability guideline</kbd>
** <s><kbd>style guideline</kbd></s> &nbsp;– ''use {{tl|MoS guideline}}'' instead
*For <kbd>{{var|category sort key}}</kbd> such as notability or naming conventions guidelines, use what is in the parenthetical disambiguator, and capitalise it. For example:
**[[Wikipedia:Notability (web)]]: <kbd>{{var|category sort key}}</kbd> = '''<kbd>Web</kbd>'''
**[[Wikipedia:Naming conventions (people)]]: <kbd>{{var|category sort key}}</kbd>; = '''<kbd>People</kbd>'''
*For the optional <kbd>{{var|shortcut}}</kbd>, use an established [[Wikipedia:Shortcut|shortcut]]; it is not necessary to wrap it in <code><nowiki>[[...]]</nowiki></code>. For example: '''<kbd>WP:{{var|FOO}}</kbd>'''
**For the next optional shortcut, use another established shortcut. You can use up to five shortcuts in total, each as a separate parameter.
*The parameter {{para|section|y}} can be used to tweak the wording to refer to a section instead of the whole page. This is only used when an guideline of a particular sort (e.g. a naming convention) is a section in a larger combined guideline, as at [[WP:Stand-alone lists]]; it is not to be used for each section in guideline page that is all of the same category.  {{strong|The template with or without this parameter should not be used on [[WP:PROJPAGE|wikiproject advice pages]]}}; they are [[WP:Essay|essays]] not [[WP:POLICY#Guidelines|guidelines]].

==New or greatly modified guidelines require community approval==
{{main|Wikipedia:How to contribute to Wikipedia guidance}}
If you or a wikiproject have drafted a new guideline or substantially revised one, the Wikipedia community must have significant time to consider the proposal and arrive at a [[WP:Consensus|consensus]] about it.  See the [[WP:PROPOSAL]] policy for the current best practices on neutrally soliciting input on a proposal from as wide a selection of the community as is practical.

'''This is usually done with a [[WP:RFC|request for comment (RfC)]] at the proposal's talk page, and advertised at [[Wikipedia:Village pump (proposals)]] ([[WP:VPPRO]])''', or the RfC may be hosted at VPPRO itself. Give notice at the talk pages of other relevant parts of Wikipedia, such as those of closely related existing policies and guidelines, as well as [[WP:WikiProject|wikiprojects]] likely to have a stake in the outcome. If the proposal is not highly topical and may affect the encyclopedia as a whole, or may be controversial, using [[WP:Centralized discussion]] may also be advised. 

For more suggestions and background on how to go from a proposal to a Wikipedia guideline, see [[:Category:Wikipedia proposals]] and [[Wikipedia:How to contribute to Wikipedia guidance]].

==See also==
* {{tl|MoS-guideline}}  – for the style guidelines that are actually part of the [[WP:MOS|Manual of Style]] (few if any are not)
* {{tl|Supplement}} – for a special kind of Wikipedia essay that is a consensus-accepted supplement to a guideline
* {{tl|Proposed}} – to solicit comments from the wider community before declaring a page to be a guideline; please also notify [[Wikipedia:Village pump (proposals)]]
* {{tlg|Rfc|alttext=Rfc&nbsp;|&nbsp;policy}} – to solicit comments from the community about a proposed guideline, major changes to an existing guideline, or removing guideline status; please also notify [[Wikipedia:Village pump (policy)]]
* {{tlg|Rfc|alttext=Rfc&nbsp;|&nbsp;style}} – to solicit comments from the community about a proposed style guideline, major changes to an existing style guideline, or removing guideline status; please also notify [[Wikipedia:Village pump (policy)]]
* For other [[:Category:Wikipedia header templates|Wikipedia header templates]] (for policies, essays, wikiprojects, etc.), see [[Wikipedia:Template messages/Project namespace|Template messages/Project namespace]].

{{When on basepage
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Wikipedia policy and guideline header templates]]
[[Category:Wikipedia Manual of Style templates]]
}}