Thumper: Added category

2016-08-10T00:11:58Z

Added category

← Older revision		Revision as of 00:11, 10 August 2016
Line 40:		Line 40:
	Once you have the documentation safely wrapped in <code><noinclude></code>, nobody can break your template by editing the template's documentation - they would have to edit the template code itself (or the code of some other template your template includes).		Once you have the documentation safely wrapped in <code><noinclude></code>, nobody can break your template by editing the template's documentation - they would have to edit the template code itself (or the code of some other template your template includes).
	So don't forget those <code><noinclude></code> tags!		So don't forget those <code><noinclude></code> tags!

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

Thumper: Created template documentation

2016-08-09T23:46:57Z

Created template documentation

New page

This template is for adding documentation to other templates.

=== Usage ===

To add documentation to a template, simply add the following to the bottom of the template code:

<pre>
<noinclude>
{{doc}}
</noinclude>
</pre>

It is usually important that there be ''no space at all'' between the last bit of the template code, and the documentation code lines.
Normally you also want to wrap the actual template code in <code><includeonly></code> tags.

For example, if your template code looked like this:

<pre>
This is {{{my}}} template.
</pre>

To add documentation, first you wrap the template in <code><includeonly></code> tags:

<pre>
<includeonly>This is {{{my}}} template.</includeonly>
</pre>

Then you add the {{tlx|doc}} template (wrapped in <code><noinclude></code> tags):

<pre>
<includeonly>This is {{{my}}} template.</includeonly><noinclude>
{{doc}}
</noinclude>
</pre>

If no documentation page exists for the template this documentation template is used for, there will be a warning on the template page.
The template will also be added to the hidden category [[:Category:Templates needing documentation|Templates needing documentation]].

It is very important to use the <code><noinclude></code> tags to wrap the documentation, otherwise it will propagate up to any pages that include the template.
Once you have the documentation safely wrapped in <code><noinclude></code>, nobody can break your template by editing the template's documentation - they would have to edit the template code itself (or the code of some other template your template includes).
So don't forget those <code><noinclude></code> tags!

Template:Doc/Documentation - Revision history

Thumper: Added category

Thumper: Created template documentation