Help:Template documentation

From MTG Wiki
Jump to navigation Jump to search

In MediaWiki, documentation should be provided for end-users that use the template. It is recommended that documentation should appear in a subpage, to separate the template code, and potentially protect the template from any changes. See Template doc page pattern how this can be done.

Suggested methods is to use the following headers for the main body of the documentation:

A single paragraph describing the use.

== Usage ==
Use <pre>{{templatename|var1|var2}}</pre> to
show the usage of  variables used in the Template.

== Examples ==
Show single examples, and how the template should be used

== See also ==
Typically links to other similar templates

If the doc subpage method is used, then the categories and interwiki links need to go into specific locations, provided in the pattern template. These two templates can likely be used:

  • {{Documentation}} - to be called within noinclude tags on the main template page. The link included in this template makes it easy to create a doc subpage if not already present.
  • {{Documentation subpage}} - marks the /doc subpage "under" the main template page