Jump to content

Template:Documentation

From NixOS Wiki

Template Documentation [edit source| uses| help]

This template is used for providing documentation for templates. It will "grab" the documentation from the /Doc subpage under the template it's used for. For example, using it on Template:Documentation would grab the documentation from Template:Documentation/Doc.

Usage

In general, the documentation should not be part of the template itself, thus you might want to do follow this general pattern:

<includeonly>
  <!-- Template-specific code -->
<noinclude>{{Documentation}}</noinclude>

Writing the documentation

It is generally a good idea to write the documentation before applying this template to the page you are working on. In this way, you're avoiding displaying the missing red link for anyone while your work is in progress.

Keep in mind that all documentation headings should be one level lower than what you'd normally write, because the heading Template Documentation is a level 2 header already. For example, a documentation outline might be:

Some introduction text...

=== Usage ===

Information about how to use your template...

=== Parameters ===

Available options and parameters...

=== Technical details ===

Any technical information about the template's implementation under the hood...

Template data

Provide documentation for a template, under the /Doc subpage

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
No parameters specified