Style Guide

From E30 Zone Wiki
Revision as of 19:33, 12 February 2013 by Grrrmachine (talk | contribs)
(diff) ←Older revision | view current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

The Wiki is bigger than one man, but we all speak with the same voice. As the Wiki grows, it's important for each page to read in the same way, not just in the formatting but the quality of the language as well. So for consistency's sake, the Style Guide outlines some of the common terms to use, as well as common mistakes to watch out for.

BMW

The mother company's name is always in capital letters.

E30

The E30 is always referred to with a Capital E.

Linking

Internal

Internal are links to other pages inside the E30 Wiki.

The Overview section of any Technical page should aim to provide links to all the parts listed within the Components section of the same page.

Within each part of the Components section, there should be a link to any other part mentioned on the same page. Only the first mention needs to a link.

If you refer to a different element of the car within a document, such as mentioning the Brakes on the Steering page, then create a link to that element the first time you mention it. You don't need to link to it again within the article.

External

External links go to pages outside the Wiki. External links are done inside single square brackets ([ ]) with a space between the link and text you wish to display.

If you mention an E30 Zone member, especially for the purpose of giving credit, then provide a link to that user's profile. The E30 Zone Forum allows you to search for their name, so find their profile and link to it.

Provide a link to another forum or website if you have used their material, either in whole or in part.

Punctuation

Learn the difference between a comma (,) and a full stop (.) If you don't put in full stops occasionally, the text becomes a rambling nonsense. Learn when to put a stop to your text, so that the reader can digest what you've just said and move on to the next jewel of information.

There/Their/They're

There
Used to show that something is not here.

I think something fell off your rusty old turd back there

Their
It belongs to them.

Tourings are less prone to rust than other E30s, although their tailgates rot out quicker than a Citroen's

They're
A short form of They Are.

The immense power that the 318iS is able to produce is why they're known as the Baby M3