Template:Documentation/doc

From Deep Blue Robotics Wiki
Revision as of 02:52, 5 July 2007 by Pathoschild (Talk) (+ "Explanation", shortened and expanded from removed section)

Jump to: navigation, search

Template:Documentation subpage Template:Shortcut

Usage

On template (or other) pages

This template displays a "(Namespace) documentation" box like the one you are seeing now. Place the following code on the template (or other) page, and edit the documentation page (click the "[edit]" link after you save) where you can put instructions, categories, et cetera.

<noinclude>{{documentation}}</noinclude>

On documentation subpages

Please add the following code at the top of the subpage to put it in Category:Documentation subpages; this keeps it out of Special:Uncategorizedpages and links back to the main page.

<noinclude>{{documentation subpage}}</noinclude>

Typically documentation subpages are not also put in the categories in which the page the documentation refers to is put.

Explanation

Transcluding a template on a page adds to the Template:Peis of that page, which is the amount of text the server must parse to render the page. Hidden content on a template page, like documentation, adds to this include size even though it doesn't appear on the page. Transcluding the documentation from a subpage reduces this include size to the negligible number of bytes added by the characters on the template page itself, thus reducing server load.

Using a subpage also allows anyone to edit the documentation, categories, or interwiki links of a protected template.


See also