Wiki Template Documentation: Difference between revisions
No edit summary |
>Arkalor's Bot m (Text replace - "Category:Page Template" to "Category:Page Templates") |
||
| (One intermediate revision by one other user not shown) | |||
| 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". | ||
| Line 24: | Line 25: | ||
See [[??]] for an example of template documentation. | See [[??]] for an example of template documentation. | ||
[[Category:Page | [[Category:Page Templates]] | ||
Latest revision as of 02:14, 9 April 2014
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 Edit
{{Related|Wiki Templates|Wiki Template Documentation}}
== Syntax ==
== Usage ==
<noinclude>[[Category:Template Documentation]]</noinclude>
Example Edit
See ?? for an example of template documentation.