ResourceWiki:Manual of Style

From ResourceWiki

The below are guidelines that describe the style with which pages and page content should be made. For a more general guide to editing and interacting on ResourceWiki, see the ResourceWiki:General usage guide.

Contents

New page titles

When a new page is created, these conventions are to be followed:

General format

The page titles should follow this format:

[SRD:]Title ([edition|CS] type)
  • If the content is from the System Reference Document, SRD: is used as a prefix; see below.
  • Title is the actual title of the page. It must conform to all the rules in this section.
  • Edition|CS is where you type the edition in short format if the page contains general content, or type the campaign setting name if it is campaign-setting-specific.
    • Editions should follow the #e or #.5e format.
    • There is no need to add edition if the page is campaign-setting-specific, campaign settings mostly use only one edition.
    • If the page is neither edition-specific nor campaign-setting-specific, none of them will be added to the parenthetical classification.
  • Type is the kind of content the page is about. It could be monster, NPC, spell, house rule, etc.
  • Examples:
Acid splash (3.5e spell)
Violent Attack (Sultansword feat)
Death die (house rule)

SRD vs homebrew

SRD information is kept seperate from homebrew in ResourceWiki.

  • If a page is created for SRD content, use SRD: before the title.
  • If it is homebrew, no prefix is needed.
SRD:Races contains a list of races from the System Reference Document, while Races contains a list of homebrew races.

Singular vs plural

  • For a skill, feat, spell, power, house rule, or a concept, use singular.
fireball is a proper title for a fireball spell. Creating a page titled fireballs is not a good idea, because it suggests that the name itself contains a plural word (as in shades).
  • For pages that list items, use plural if the title tells what items are listed.
Spells contains a list of spells, and the title is plural. Magic also contains a number of items listed, but it does not list "magic", so it is singular.

Capitalization

See SRD for example.

A/An/The in page titles

  • Avoid using A/An/The in page titles, except for proper names when you must use "The"
    • Almost every simple noun could be described with a "a/an". For consistency, and for making it easier to link to these subjects in a sentence, avoid using "a/an".
    • Use "The" if that is part of the proper name of the item. This is a very rare case though, so be sure before doing it.

Simplify

  • Generally, the simpler the title, the better. For example, rather than "List of all spells for Dungeons & Dragons", the title Spells says it all and is easier to find on doing a search. Exclude unnecessary words such as "List of" for this reason. If the specific purpose or significance of a page needs further explanation, go into detail in the body of the article.
  • Do not use "Dungeons & Dragons" in page titles--This is ResourceWiki, and it is a D&D database. Everyone knows what game you're referring to.

Conventions within articles

Headings

  • All headings should use the same capitalization rules below.
  • Bold and links should be avoided in headings. Links in particular may be difficult for some users to see within headings.

Capitalization

Use lower-case, with these exceptions:

  • The following are always capitalized
    • abilities (Dexterity, Strength)
    • creature subtypes (Aquatic, Incorporeal)
    • creature types (Monstrous Humanoid, Undead)
    • long forms of terms abbreviated by acronyms (Armor Class, Hit Dice)
    • proper nouns (Jozan, Tordek)
    • saves (Fortitude, Reflex)
    • sizes (Gigantic, Medium)
  • The following are always all-caps
    • ability abbreviations (DEX, STR)
    • acronyms (AC, HD)

Bold

  • Use bold for emphasis. Create bold text by wrapping it in three single quotes; i.e. '''campaign setting''' results in campaign setting.

Italics

  • Italics are reserved for names of spells, spell-like abilities and abilities that mimic spell-like abilities. Create italic text by wrapping it in two single quotes; i.e. ''fireball'' results in fireball.
  • Using italics for emphasis should be avoided. Use bold for emphasis.

Links

  • Wikify text where appropriate. Wikify text by wrapping it in double brackets; i.e. [[Hit Dice]] will result in Hit Dice.
  • You can link text to a page with a different title. This is especially helpful when you do not want to include namespaces or parentheses. To do this, use the form [[Page title|displayed text]]; i.e. [[SRD:Fireball (3.5e spell)|''fireball'']] will result in fireball.

Categorize

Please place the article in any of our categories with the following line of code: [[Category:Categoryname]] at the very end of the article. For the complete list of categories, see Special:Categories. Be as specific as you can with the categories. Remember that sometimes articles will fit into more than one category.

  • If you are unsure what category your article fits in, you can leave it uncategorized. Sysops and others can use a special page for uncategorized pages to see a list of pages that have no category. The goal is to keep this list empty.

Never sign your contributions to articles

The wiki concept is not single authorship, but rather a collaborative effort. You might be extra proud of your article, but it will be mercilessly ripped apart by the rest of us. Signatures found in the articles are to be deleted.

See also: ResourceWiki:No possession of edits

Always sign your contributions to talk pages

Always sign your comments on a talk or discussion page using the signature button on the edit toolbar, or with four tildes: ~~~~.

No personal pronouns

The second person pronoun "you", and the first person pronouns "I" and "we" as well as "one" should not be used in articles. The implicit second person pronoun "you" should not be used in imperative sentences.

Spelling and grammar

Before submitting, use the Show preview button and read again what you wrote. You might find that you did not convey your idea as you wanted. Hit the preview button until you are happy and proud with your submission.

  • If you don't feel confident with your writing style, spelling and grammar, include the message "Proofread me" in the edit summary, encouraging another active user to read and edit your contributions.
  • Utilize US English spellings. If British English spellings are used it is not a major priority to correct them but you may.
    • Do not change US English spellings into British English. The site is hosted in the US and Dungeons & Dragons was originated in the US.
  • Using contractions in articles are discouraged, unless they represent a particular speech. If contractions are used it is not a major priority to correct them but you may.
  • Spelling and grammar rules are for articles. Do not correct other people's spellings or grammar in talk pages. See ResourceWiki:Discussion policy for more detail.

Redirections and lists

Duplicate or redundant articles should not be created. A redirection page is one that automatically shunts a search for a particular keyword into another existing page. Redirect to a page by typing only #REDIRECT [[Page name here]] in that article.

Do not create pages with just lists of article links that duplicate existing categories. These should be redirected to the category in question by typing #REDIRECT [[:Category:Name here]] (adding the first ":" is necessary to avoid categorizing the redirect page back into itself).

List articles should have some limited information aside from just listing links (such as brief spell descriptions); however, they should not go into a huge amount of detail of each item. Lists that consist of many items should be broken down into sections to make it easier for the user to browse through.

Disambiguations

The purpose of a disambiguation page is to assist a user who has searched with an ambiguous term in quickly finding the article actually being sought.

Begin a disambiguation page with the ambiguous term or terms in bold and a brief disambiguating phrase such as "may refer to", followed by a colon. This should be followed by a bulleted list of links to the various applicable unambiguous pages.

  • No bold should be found anywhere in the bulleted list.
  • Only one wikilink should appear in each item in the bulleted list. More than one wikilink per line defeats the purpose of disambiguation.
    • Exception: if the main link in the disambiguation line is a redlink (i.e. if an article has not been created for it yet), other items in the line may be wikilinked, in order to assist a user interested in initiating an article for the redlinked subject with starting points for his or her research.
  • Be succinct with each line, assisting in quick disambiguation.
  • Do not place periods at the end of the lines. If a line needs a period because it has more than one sentence, be merciless in editing the line down until no period is required.

The {{disambig}} template tag should be placed at the top of the disambiguation page to categorize it as such.

Retrieved from "http://www.dndresources.com/wiki/index.php/ResourceWiki:Manual_of_Style"

This page has been accessed 1,840 times. This page was last modified 22:58, 4 May 2008.


Area Navigation

Find
Browse
Main Page
Community portal
Current events
Recent changes
Random page
Help
Donations
Edit
View source
Editing help
This page
Discuss this page
Post a comment
Printable version
Context
Page history
What links here
Related changes
My pages
Log in / create account
Special pages
New pages
File list
Statistics
Bug reports
More...

 

Site Navigation

  • DnDResources Home
  • ResourceItems
  • ResourceBooks
  • ResourceWiki
  • ResourceCommunity