Difference between revisions of "Wiki Style Guide"

From Dreamwidth Notes
Jump to: navigation, search
m
(added template descriptions)
Line 1: Line 1:
 +
== General tone/style ==
 +
 +
Articles should be written as accessibly as possible.
 +
 
== Page sections ==
 
== Page sections ==
  
Line 16: Line 20:
  
 
== Templates ==
 
== Templates ==
 +
 +
Templates are there to help you!  Here is a list of templates you can use.  They all have instructions for their use if you go to their page.
 +
 +
* There are templates to classify articles needing different kinds of attention: [[Template:Cleanup]] (for articles that need reworking of existing content), [[Template:Expand]] (for articles that need more content), [[Template:Update]] (for articles with outdated or inaccurate content)
 +
* There are templates to offset notable pieces of information: [[Template:Warn]] (for important information that can have adverse affects) and [[Template:Note]] (for information that should be highlighted in a box to the side)
 +
* When referring to [[:Category:Database Tables|database tables]], you can use [[Template:DBTable]] to refer to a table and [[Template:DBField]] to refer to a field in a table.  They'll do all of the tricky formatting to link it up nicely.

Revision as of 15:55, 27 March 2009

General tone/style

Articles should be written as accessibly as possible.

Page sections

Pages should be sectioned if they are long enough to warrant it, or if that would help lay out the information better. Sections are delimited like this:

= Section 1 =
== Section 1.1 ==
=== Section 1.1.1 ===
==== Section 1.1.1.1 ===
===== Section 1.1.1.1.1 =====

It's good to start out at the level of ==, just in case you want to reorganize things into more sections later. We prefer spaces in between your ==s and the section title itself, and a line of space before and after each title (unless you have a section at the very top of the page, in which case you can skip the line before).

Categories

Pages should be categorized, and category tags should go at the bottom of the page.

Templates

Templates are there to help you! Here is a list of templates you can use. They all have instructions for their use if you go to their page.

  • There are templates to classify articles needing different kinds of attention: Template:Cleanup (for articles that need reworking of existing content), Template:Expand (for articles that need more content), Template:Update (for articles with outdated or inaccurate content)
  • There are templates to offset notable pieces of information: Template:Warn (for important information that can have adverse affects) and Template:Note (for information that should be highlighted in a box to the side)
  • When referring to database tables, you can use Template:DBTable to refer to a table and Template:DBField to refer to a field in a table. They'll do all of the tricky formatting to link it up nicely.