Welcome to the Lylat Wiki, all about the Star Fox series! If you'd like to help out, please take a look at our community portal.

Difference between revisions of "Lylat Wiki:Template Standards"

From Lylat Wiki, your source on Star Fox information. By Fans, for Fans.
Jump to navigationJump to search
m (Text replace - 'Category:Documentation' to '{{PAGENAME}}')
Line 77: Line 77:
<!-- cats -->
<!-- cats -->
</includeonly>
</includeonly>
<noinclude>[[Category:Documentation]]</noinclude></pre>
<noinclude>[[Category:Documentation|{{PAGENAME}}]]</noinclude></pre>


== Maintenance ==
== Maintenance ==

Revision as of 04:31, 17 August 2010

Shortcuts: Usage , [[ Template:LW:TS ]]
General Pepper.png

General Pepper:

Peppy, When you have a chance, please look at this policy. I would like your opinion on it.

Peppy Hare:

Right, I will place my feedback on the talk page.
Peppy Hare.png
This draft policy is recommend by a member in accordance with LW:Draft. You are free to make small changes, as long as the original purpose of the policy is preserved. Any feedback should be provided on the talk page.

Templates are used to make it easier on a page to store information, as some of the information is stored elsewhere. Templates are used to make it easier on the editors, as to provide a common content and save time instead of placing the exact same content in different locations. Templates are also used as tools to help direct community involvement for the maintenance of an article. But what makes a "Good Template"?

While there will never be an absolute way to say "this is a good template", there are certain things we should expect from each template and there respective pages (such as documentation and usage information). Due to the nature and infinitely diverse uses of templates, having a common expectation for each page does help standardize the pages.

But please note:The following are not absolute rules. They are not binding in anyway. They instead should be interpreted on a case by case basis, where each each template's page should be best catered to explaining how the template works and how to use it.

Names

Content

when a template is placed into another page, through a process called "transclusion", it should have one of two results:

  1. it looks natural where it was place on the article; enhancing, rather than detracting from the receiving pages quality.
  2. it brings the user of a page to the attention of something, such as someone believing that a article is inaccurate.

Sections

If a template generates a section breaker (through === Section headers ===), then that section header is not only subject to these guidelines, but also to the guidelines that the receiving page(s) are under.

For more, please see: Lylat Wiki:Section Standards.

Tables

Documentation

Each template should have some kind of documentation telling you how to use it.

In order to generate a documentation page, place <noinclude>{{doc}}</noinclude> at the very bottom of the template, and a /doc red link will show up when you save. Click this link to go to the documentation subpage.

On the actual documentation page, we recommend you put the following:

  • a Documentation Shell, which is intended to provide easier access to the template page, the name of the template, and related templates.
  • The three sections: Purpose, usage and example.

Documentation Shell

Title sample usage See #doc_1
documentation shell
{{documentation shell
| name = 
| info = 
| see also = 
}}
Use this template for all characters.

Notes:

  1. Required Parameters are in bold, followed by explanation of usage. Italics parameters have a related behavior change, when you insert a certain value. Please Click the link to the template for more information

Sections

==Purpose==
==Usage==
=== Parameters ===
{{Parameters-table-top}}
|-
| <!-- one row per parameter --> 
| 
| 
|-
| colspan=3 | none <!-- for no parameters -->
|-
{{parameters-table-bottom}}
|} 

==Example==
<pre>
{{Template Name
| param 1 =
| param 2 = 
| param 3 = 
}}
</pre> <!-- note: use an actual less than sign than the html equailavent &lt; -->
<includeonly>
<!-- cats -->
</includeonly>
<noinclude>[[Category:Documentation|{{PAGENAME}}]]</noinclude>

Maintenance

Template:Template-Maintance-Templates

Actions

Template:General-actions

Discussions

Typical Types of Templates

Infoboxes

Navigation

Shortcuts

Maintenance