Editing Incubator escapee wiki:Template namespace (section)

=== Documentation ===
{{main|Wikipedia:Template documentation}}
Because templates represent a step up in difficulty for the novice editor, documentation should be provided which describes its usage (optional parameters) and scope (where it should be used). There are two different ways to do this:

One option is to use the {{t|documentation}} template to add a minor description directly onto the template page. As mentioned in {{slink||Line breaks}}, the first {{tag|noinclude|o}} tag should be placed on the same line as the last character of the actual template. For example:
<syntaxhighlight lang=wikitext>
'''This is a {{{1}}} article.'''<noinclude>
{{documentation|content=
Place this template on any article that requires description. It 
takes one parameter, an adjective used to describe the article. 
For example, {{article-describe|bad}} produces the text, 
'''This is a bad article.'''
}}
</noinclude>
</syntaxhighlight>

Another alternative is to create a formal [[Wikipedia:DOC|/doc subpage]] for the documentation (preferred for templates with multiple parameters, etc.). The {{t|documentation}} template is still called, but all of the displayed text will be transcluded from the template's /doc subpage.
<syntaxhighlight lang=wikitext>
'''This is a {{{1}}} article.'''<noinclude>
{{documentation}}
</noinclude>
</syntaxhighlight>