Wiki Template Documentation: Difference between revisions

From Drunkapedia
Jump to: navigation, search
imported>Tlosk
No edit summary
imported>Tlosk
mNo edit summary
Line 1: Line 1:
{{RightToC}}
{{RightToC}}
{{Related|Page Templates|Wiki Templates|{{mtl|Documentation}}}}
{{Related|Page Templates|Wiki Templates|{{mtl|Documentation}}}}
Segregating documentation to a subpage means that updates to the documentation don't cause large numbers of pointless template updates across the wiki, and the template itself can be protected if necessary (without protecting the documentation). That is, each time a change is made to a template, all pages that use that template are updated, which can be significant for widely used templates. Similarly, when changes are needed to a widely used template, experiment first on {{tl|Sandbox}} so only a single change will be needed to the template itself.
Segregating documentation to a subpage means that updates to the documentation don't cause large numbers of pointless template updates across the wiki, and the template itself can be protected if necessary (without protecting the documentation). That is, each time a change is made to a template, all pages that use that template are updated, which can be significant for widely used templates. Similarly, when changes are needed to a widely used template, experiment first on {{tl|Sandbox}} so only a single change will be needed to the template itself.
* Documentation for templates should be stored on a subpage of the format "Template Name/Doc".
* Documentation for templates should be stored on a subpage of the format "Template Name/Doc".

Revision as of 12:06, 3 December 2009

Related topics: Page Templates, Wiki Templates, {{Documentation}}

Segregating documentation to a subpage means that updates to the documentation don't cause large numbers of pointless template updates across the wiki, and the template itself can be protected if necessary (without protecting the documentation). That is, each time a change is made to a template, all pages that use that template are updated, which can be significant for widely used templates. Similarly, when changes are needed to a widely used template, experiment first on {{Sandbox}} so only a single change will be needed to the template itself.

  • Documentation for templates should be stored on a subpage of the format "Template Name/Doc".
  • Refer to the documentation by placing <noinclude>{{Documentation}}</noinclude> at the bottom of the template page.
  • Under "Syntax" include examples that are copy/paste friendly using the pre tag of the template syntax.
  • Under "Usage" include information about where the template should be used and any special parameter information. If appropriate, provide examples to make usage as clear as possible.


Wiki Code

{{Related|Wiki Templates|Wiki Template Documentation}}
== Syntax ==


== Usage ==


<noinclude>[[Category:Template Documentation]]</noinclude>

Example

See ?? for an example of template documentation.